@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,212 @@
1
+ var w = Object.defineProperty;
2
+ var m = (n, e, s) => e in n ? w(n, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : n[e] = s;
3
+ var a = (n, e, s) => m(n, typeof e != "symbol" ? e + "" : e, s);
4
+ import { useMemo as g, useCallback as f } from "react";
5
+ import { u as v, r as p, a as S, l as A, b as k, E } from "./index-CKRN-xJp.js";
6
+ import { u as B, a as _ } from "./selectors-BvJepq6H.js";
7
+ const X = (n) => {
8
+ const { session: e } = v(), s = B(), i = _(), o = JSON.stringify(n ?? null), t = g(
9
+ () => n ? p(n) : i ?? p(),
10
+ [o, i]
11
+ // eslint-disable-line react-hooks/exhaustive-deps
12
+ ), r = t.tiers, l = f(
13
+ (u) => {
14
+ const h = e.store.getSnapshot().quality;
15
+ h && e._setQuality(S(h, t, u, performance.now()));
16
+ },
17
+ [e, t]
18
+ ), d = f(
19
+ (u) => {
20
+ const h = e.store.getSnapshot().quality;
21
+ h && e._setQuality(A(h, t, u, performance.now()));
22
+ },
23
+ [e, t]
24
+ ), y = f(() => {
25
+ const u = e.store.getSnapshot().quality;
26
+ e._setQuality(
27
+ k(t, (u == null ? void 0 : u.signals) ?? E, performance.now())
28
+ );
29
+ }, [e, t]);
30
+ return g(
31
+ () => ({
32
+ tier: (s == null ? void 0 : s.decision.tier) ?? null,
33
+ index: (s == null ? void 0 : s.index) ?? -1,
34
+ tiers: r,
35
+ decision: (s == null ? void 0 : s.decision) ?? null,
36
+ history: (s == null ? void 0 : s.history) ?? [],
37
+ signals: (s == null ? void 0 : s.signals) ?? null,
38
+ locked: (s == null ? void 0 : s.locked) ?? !1,
39
+ setTier: l,
40
+ lock: () => d(!0),
41
+ unlock: () => d(!1),
42
+ reset: y,
43
+ state: s
44
+ }),
45
+ [s, r, l, d, y]
46
+ );
47
+ }, C = 256 * 1024 * 1024;
48
+ class Q {
49
+ constructor(e = {}) {
50
+ a(this, "entries", /* @__PURE__ */ new Map());
51
+ a(this, "listeners", /* @__PURE__ */ new Set());
52
+ a(this, "budget");
53
+ a(this, "now");
54
+ a(this, "evictions", 0);
55
+ a(this, "hits", 0);
56
+ a(this, "misses", 0);
57
+ /** Memoised `getStats()` result; cleared on every change so `useSyncExternalStore` sees a stable snapshot. */
58
+ a(this, "statsSnapshot", null);
59
+ this.budget = e.budgetBytes ?? C, this.now = e.now ?? (() => typeof performance < "u" ? performance.now() : Date.now());
60
+ }
61
+ /** Acquire `asset` on behalf of `ownerId`; shares an in-flight or loaded value. */
62
+ acquire(e, s) {
63
+ let i = this.entries.get(e.key);
64
+ if (i && i.status === "error" && (this.entries.delete(e.key), i = void 0), !i) {
65
+ this.misses += 1;
66
+ const o = typeof AbortController < "u" ? new AbortController() : null, t = {
67
+ definition: e,
68
+ status: "loading",
69
+ value: void 0,
70
+ bytes: 0,
71
+ owners: /* @__PURE__ */ new Set([s]),
72
+ promise: null,
73
+ controller: o,
74
+ error: null,
75
+ lastUsed: this.now(),
76
+ disposed: !1
77
+ };
78
+ return t.promise = e.load((o == null ? void 0 : o.signal) ?? new AbortController().signal).then((r) => {
79
+ var l, d;
80
+ if (t.disposed || this.entries.get(e.key) !== t)
81
+ throw (l = e.dispose) == null || l.call(e, r), new Error(`Asset "${e.key}" was released before it loaded`);
82
+ return t.value = r, t.bytes = Math.max(0, Math.round(((d = e.bytes) == null ? void 0 : d.call(e, r)) ?? 0)), t.status = "ready", t.promise = null, this.notify(), this.enforceBudget(), r;
83
+ }).catch((r) => {
84
+ const l = r instanceof Error ? r : new Error(String(r));
85
+ throw this.entries.get(e.key) === t && !t.disposed && (t.status = "error", t.error = l, t.promise = null, this.notify()), l;
86
+ }), this.entries.set(e.key, t), this.notify(), t.promise;
87
+ }
88
+ return this.hits += 1, i.owners.add(s), i.lastUsed = this.now(), this.notify(), i.status === "ready" ? Promise.resolve(i.value) : i.promise;
89
+ }
90
+ /** Start loading without holding a reference (warm the cache). */
91
+ preload(e) {
92
+ const s = "__preload__";
93
+ return this.acquire(e, s).finally(() => this.release(e.key, s));
94
+ }
95
+ /** Drop `ownerId`'s reference. The value stays cached until evicted or disposed. */
96
+ release(e, s) {
97
+ var o;
98
+ const i = this.entries.get(e);
99
+ !i || !i.owners.delete(s) || (i.lastUsed = this.now(), i.owners.size === 0 && i.status === "loading" && ((o = i.controller) == null || o.abort(), i.disposed = !0, this.entries.delete(e)), this.notify(), this.enforceBudget());
100
+ }
101
+ /** Synchronous read of a loaded value (or `undefined`). Does not take a reference. */
102
+ get(e) {
103
+ const s = this.entries.get(e);
104
+ return (s == null ? void 0 : s.status) === "ready" ? s.value : void 0;
105
+ }
106
+ has(e) {
107
+ return this.entries.has(e);
108
+ }
109
+ entry(e) {
110
+ const s = this.entries.get(e);
111
+ return s ? b(e, s) : void 0;
112
+ }
113
+ list() {
114
+ return Array.from(this.entries, ([e, s]) => b(e, s));
115
+ }
116
+ setBudget(e) {
117
+ this.budget = e, this.enforceBudget(), this.notify();
118
+ }
119
+ /**
120
+ * Dispose unreferenced values, least recently used first, until usage is
121
+ * within the budget (or `bytesToFree` is reclaimed). Referenced values are
122
+ * never touched. Returns the bytes reclaimed.
123
+ */
124
+ evict(e) {
125
+ const s = e ?? Math.max(0, this.usage() - (Number.isFinite(this.budget) ? this.budget : 1 / 0));
126
+ if (s <= 0) return 0;
127
+ const i = Array.from(this.entries).filter(([, t]) => t.owners.size === 0 && t.status === "ready").sort((t, r) => t[1].lastUsed - r[1].lastUsed);
128
+ let o = 0;
129
+ for (const [t, r] of i) {
130
+ if (o >= s) break;
131
+ o += r.bytes, this.disposeEntry(t, r), this.evictions += 1;
132
+ }
133
+ return o > 0 && this.notify(), o;
134
+ }
135
+ /** Dispose every unreferenced value (route change, scene teardown). Returns the bytes freed. */
136
+ disposeUnreferenced() {
137
+ let e = 0;
138
+ for (const [s, i] of Array.from(this.entries))
139
+ i.owners.size === 0 && (e += i.bytes, this.disposeEntry(s, i));
140
+ return e > 0 && this.notify(), e;
141
+ }
142
+ /** Dispose everything, referenced or not (app / session shutdown). Owners are forgotten. */
143
+ disposeAll() {
144
+ for (const [e, s] of Array.from(this.entries)) this.disposeEntry(e, s);
145
+ this.notify();
146
+ }
147
+ /** Current statistics. The object is reused until the cache changes, so it is safe as a store snapshot. */
148
+ getStats() {
149
+ if (this.statsSnapshot) return this.statsSnapshot;
150
+ let e = 0, s = 0, i = 0, o = 0, t = 0;
151
+ for (const r of this.entries.values())
152
+ r.owners.size > 0 && (e += 1), r.status === "loading" && (s += 1), r.status === "error" && (i += 1), r.status === "ready" && (o += r.bytes, r.owners.size === 0 && (t += r.bytes));
153
+ return this.statsSnapshot = {
154
+ assets: this.entries.size,
155
+ referencedAssets: e,
156
+ loadingAssets: s,
157
+ erroredAssets: i,
158
+ usageBytes: o,
159
+ reclaimableBytes: t,
160
+ budgetBytes: this.budget,
161
+ overBudget: o > this.budget,
162
+ evictions: this.evictions,
163
+ hits: this.hits,
164
+ misses: this.misses
165
+ }, this.statsSnapshot;
166
+ }
167
+ subscribe(e) {
168
+ return this.listeners.add(e), () => {
169
+ this.listeners.delete(e);
170
+ };
171
+ }
172
+ usage() {
173
+ let e = 0;
174
+ for (const s of this.entries.values()) s.status === "ready" && (e += s.bytes);
175
+ return e;
176
+ }
177
+ enforceBudget() {
178
+ Number.isFinite(this.budget) && this.usage() > this.budget && this.evict();
179
+ }
180
+ disposeEntry(e, s) {
181
+ var i, o, t;
182
+ if (!s.disposed) {
183
+ if (s.disposed = !0, (i = s.controller) == null || i.abort(), s.status === "ready" && s.value !== void 0)
184
+ try {
185
+ (t = (o = s.definition).dispose) == null || t.call(o, s.value);
186
+ } catch (r) {
187
+ console.warn(`[xr-sdk assets] dispose threw for ${e}`, r);
188
+ }
189
+ this.entries.delete(e);
190
+ }
191
+ }
192
+ notify() {
193
+ this.statsSnapshot = null, this.listeners.forEach((e) => e());
194
+ }
195
+ }
196
+ const b = (n, e) => ({
197
+ key: n,
198
+ status: e.status,
199
+ bytes: e.bytes,
200
+ owners: e.owners.size,
201
+ lastUsed: e.lastUsed,
202
+ error: e.error
203
+ }), U = (n) => new Q(n);
204
+ let c;
205
+ const q = () => (c || (c = U()), c);
206
+ export {
207
+ C as D,
208
+ Q as X,
209
+ U as c,
210
+ q as g,
211
+ X as u
212
+ };
@@ -0,0 +1 @@
1
+ "use strict";var S=Object.defineProperty;var v=(o,e,t)=>e in o?S(o,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):o[e]=t;var l=(o,e,t)=>v(o,typeof e!="symbol"?e+"":e,t);const f=require("react"),d=require("./index-Sho4F4it.cjs"),p=require("./selectors-QB2qsaxy.cjs"),k=o=>{const{session:e}=d.useXRContext(),t=p.useXRQualityState(),i=p.useXRQualityConfig(),n=JSON.stringify(o??null),s=f.useMemo(()=>o?d.resolveQualityConfig(o):i??d.resolveQualityConfig(),[n,i]),r=s.tiers,a=f.useCallback(u=>{const c=e.store.getSnapshot().quality;c&&e._setQuality(d.setQualityTier(c,s,u,performance.now()))},[e,s]),h=f.useCallback(u=>{const c=e.store.getSnapshot().quality;c&&e._setQuality(d.lockQuality(c,s,u,performance.now()))},[e,s]),g=f.useCallback(()=>{const u=e.store.getSnapshot().quality;e._setQuality(d.resetQuality(s,(u==null?void 0:u.signals)??d.EMPTY_QUALITY_SIGNALS,performance.now()))},[e,s]);return f.useMemo(()=>({tier:(t==null?void 0:t.decision.tier)??null,index:(t==null?void 0:t.index)??-1,tiers:r,decision:(t==null?void 0:t.decision)??null,history:(t==null?void 0:t.history)??[],signals:(t==null?void 0:t.signals)??null,locked:(t==null?void 0:t.locked)??!1,setTier:a,lock:()=>h(!0),unlock:()=>h(!1),reset:g,state:t}),[t,r,a,h,g])},w=256*1024*1024;class m{constructor(e={}){l(this,"entries",new Map);l(this,"listeners",new Set);l(this,"budget");l(this,"now");l(this,"evictions",0);l(this,"hits",0);l(this,"misses",0);l(this,"statsSnapshot",null);this.budget=e.budgetBytes??w,this.now=e.now??(()=>typeof performance<"u"?performance.now():Date.now())}acquire(e,t){let i=this.entries.get(e.key);if(i&&i.status==="error"&&(this.entries.delete(e.key),i=void 0),!i){this.misses+=1;const n=typeof AbortController<"u"?new AbortController:null,s={definition:e,status:"loading",value:void 0,bytes:0,owners:new Set([t]),promise:null,controller:n,error:null,lastUsed:this.now(),disposed:!1};return s.promise=e.load((n==null?void 0:n.signal)??new AbortController().signal).then(r=>{var a,h;if(s.disposed||this.entries.get(e.key)!==s)throw(a=e.dispose)==null||a.call(e,r),new Error(`Asset "${e.key}" was released before it loaded`);return s.value=r,s.bytes=Math.max(0,Math.round(((h=e.bytes)==null?void 0:h.call(e,r))??0)),s.status="ready",s.promise=null,this.notify(),this.enforceBudget(),r}).catch(r=>{const a=r instanceof Error?r:new Error(String(r));throw this.entries.get(e.key)===s&&!s.disposed&&(s.status="error",s.error=a,s.promise=null,this.notify()),a}),this.entries.set(e.key,s),this.notify(),s.promise}return this.hits+=1,i.owners.add(t),i.lastUsed=this.now(),this.notify(),i.status==="ready"?Promise.resolve(i.value):i.promise}preload(e){const t="__preload__";return this.acquire(e,t).finally(()=>this.release(e.key,t))}release(e,t){var n;const i=this.entries.get(e);!i||!i.owners.delete(t)||(i.lastUsed=this.now(),i.owners.size===0&&i.status==="loading"&&((n=i.controller)==null||n.abort(),i.disposed=!0,this.entries.delete(e)),this.notify(),this.enforceBudget())}get(e){const t=this.entries.get(e);return(t==null?void 0:t.status)==="ready"?t.value:void 0}has(e){return this.entries.has(e)}entry(e){const t=this.entries.get(e);return t?b(e,t):void 0}list(){return Array.from(this.entries,([e,t])=>b(e,t))}setBudget(e){this.budget=e,this.enforceBudget(),this.notify()}evict(e){const t=e??Math.max(0,this.usage()-(Number.isFinite(this.budget)?this.budget:1/0));if(t<=0)return 0;const i=Array.from(this.entries).filter(([,s])=>s.owners.size===0&&s.status==="ready").sort((s,r)=>s[1].lastUsed-r[1].lastUsed);let n=0;for(const[s,r]of i){if(n>=t)break;n+=r.bytes,this.disposeEntry(s,r),this.evictions+=1}return n>0&&this.notify(),n}disposeUnreferenced(){let e=0;for(const[t,i]of Array.from(this.entries))i.owners.size===0&&(e+=i.bytes,this.disposeEntry(t,i));return e>0&&this.notify(),e}disposeAll(){for(const[e,t]of Array.from(this.entries))this.disposeEntry(e,t);this.notify()}getStats(){if(this.statsSnapshot)return this.statsSnapshot;let e=0,t=0,i=0,n=0,s=0;for(const r of this.entries.values())r.owners.size>0&&(e+=1),r.status==="loading"&&(t+=1),r.status==="error"&&(i+=1),r.status==="ready"&&(n+=r.bytes,r.owners.size===0&&(s+=r.bytes));return this.statsSnapshot={assets:this.entries.size,referencedAssets:e,loadingAssets:t,erroredAssets:i,usageBytes:n,reclaimableBytes:s,budgetBytes:this.budget,overBudget:n>this.budget,evictions:this.evictions,hits:this.hits,misses:this.misses},this.statsSnapshot}subscribe(e){return this.listeners.add(e),()=>{this.listeners.delete(e)}}usage(){let e=0;for(const t of this.entries.values())t.status==="ready"&&(e+=t.bytes);return e}enforceBudget(){Number.isFinite(this.budget)&&this.usage()>this.budget&&this.evict()}disposeEntry(e,t){var i,n,s;if(!t.disposed){if(t.disposed=!0,(i=t.controller)==null||i.abort(),t.status==="ready"&&t.value!==void 0)try{(s=(n=t.definition).dispose)==null||s.call(n,t.value)}catch(r){console.warn(`[xr-sdk assets] dispose threw for ${e}`,r)}this.entries.delete(e)}}notify(){this.statsSnapshot=null,this.listeners.forEach(e=>e())}}const b=(o,e)=>({key:o,status:e.status,bytes:e.bytes,owners:e.owners.size,lastUsed:e.lastUsed,error:e.error}),A=o=>new m(o);let y;const C=()=>(y||(y=A()),y);exports.DEFAULT_ASSET_BUDGET_BYTES=w;exports.XRAssetCache=m;exports.createAssetCache=A;exports.getDefaultAssetCache=C;exports.useXRQuality=k;
@@ -0,0 +1,75 @@
1
+ import { FeedPoint, FeedSourceKind } from '../coordinates/spaces';
2
+ import { XRBodyCalibration, XRCalibration, XRCalibrationPatch, XRFaceCalibration } from './types';
3
+ export declare const CALIBRATION_VERSION: 1;
4
+ export declare const DEFAULT_CALIBRATION: XRCalibration;
5
+ /** A fresh, mutable calibration with the defaults (optionally patched). */
6
+ export declare const createCalibration: (patch?: XRCalibrationPatch) => XRCalibration;
7
+ /**
8
+ * Return a new calibration with `patch` applied. Invalid values fall back to
9
+ * the defaults rather than throwing, so a corrupt persisted blob never breaks
10
+ * the app. Never mutates `current`.
11
+ */
12
+ export declare const updateCalibration: (current: XRCalibration, patch: XRCalibrationPatch, now?: number) => XRCalibration;
13
+ /** Back to the defaults (a new object). */
14
+ export declare const resetCalibration: (now?: number) => XRCalibration;
15
+ /** Whether the calibration applies a transform at all (orientation, mirror override, scale or offset). */
16
+ export declare const isIdentityCalibration: (calibration: XRCalibration) => boolean;
17
+ /**
18
+ * Whether calibrated points should be flipped relative to the feed for this
19
+ * source. `"auto"` means "match the session", which mirrors only the webcam,
20
+ * so auto never flips a point (the feed is already mirrored); `true`/`false`
21
+ * flip only when they disagree with the session.
22
+ */
23
+ export declare const resolveCalibrationMirror: (calibration: XRCalibration, sourceKind: FeedSourceKind) => boolean;
24
+ /**
25
+ * Map a feed point (0..1, top-left origin) through the calibration: rotate by
26
+ * `orientation`, flip when the mirror override disagrees with the session,
27
+ * scale about the centre and add the offset. Pure; writes into `target` and
28
+ * never touches `point`, so raw tracker results stay untouched.
29
+ */
30
+ export declare const applyCalibrationToFeedPoint: (point: FeedPoint, calibration: XRCalibration, sourceKind: FeedSourceKind, target?: FeedPoint) => FeedPoint;
31
+ type Landmark = {
32
+ x: number;
33
+ y: number;
34
+ };
35
+ /**
36
+ * MediaPipe face-mesh indices the face measurement reads, named by MediaPipe's
37
+ * sides (263 = its left eye; the person's own left on an unmirrored feed, see
38
+ * GROUNDING "Left and right"). Only the distances between the pairs are read,
39
+ * so the side never matters here.
40
+ */
41
+ export declare const FACE_CALIBRATION_LANDMARKS: Readonly<{
42
+ leftTemple: 454;
43
+ rightTemple: 234;
44
+ leftEyeOuter: 263;
45
+ rightEyeOuter: 33;
46
+ }>;
47
+ /**
48
+ * Measure the reference face from 468+ face landmarks in feed space (what
49
+ * `FaceInfo.landmarks` / `getRawFaceTrackingData().landmarks` hold). Returns
50
+ * `null` when the landmarks are missing.
51
+ */
52
+ export declare const measureFaceCalibration: (landmarks: readonly Landmark[] | undefined, now?: number) => XRFaceCalibration | null;
53
+ /** MediaPipe pose indices the body measurement reads (MediaPipe's sides; only distances are read). */
54
+ export declare const BODY_CALIBRATION_LANDMARKS: Readonly<{
55
+ leftShoulder: 11;
56
+ rightShoulder: 12;
57
+ leftHip: 23;
58
+ rightHip: 24;
59
+ }>;
60
+ /** Measure the reference body from 33 pose landmarks in feed space. */
61
+ export declare const measureBodyCalibration: (landmarks: readonly Landmark[] | undefined, now?: number) => XRBodyCalibration | null;
62
+ /**
63
+ * How far the person is now, relative to the calibrated distance: `1` at the
64
+ * reference distance, `> 1` closer (the face reads larger), `< 1` farther.
65
+ * `null` without a face calibration or without a face. Uses the face width;
66
+ * the eye distance is the fallback when the temples are not both visible.
67
+ */
68
+ export declare const estimateFaceDistance: (landmarks: readonly Landmark[] | undefined, calibration: XRCalibration) => number | null;
69
+ /**
70
+ * Scale factor that maps the calibrated body onto the current one (`1` when
71
+ * the shoulders read the same width as at calibration). `null` without a body
72
+ * calibration or without a body.
73
+ */
74
+ export declare const estimateBodyScale: (landmarks: readonly Landmark[] | undefined, calibration: XRCalibration) => number | null;
75
+ export {};
@@ -0,0 +1,6 @@
1
+ export type { XRBodyCalibration, XRCalibration, XRCalibrationContext, XRCalibrationPatch, XRFaceCalibration, } from './types';
2
+ export { BODY_CALIBRATION_LANDMARKS, CALIBRATION_VERSION, DEFAULT_CALIBRATION, FACE_CALIBRATION_LANDMARKS, applyCalibrationToFeedPoint, createCalibration, estimateBodyScale, estimateFaceDistance, isIdentityCalibration, measureBodyCalibration, measureFaceCalibration, resetCalibration, resolveCalibrationMirror, updateCalibration, } from './calibration';
3
+ export { CALIBRATION_STORAGE_KEY, clearCalibration, loadCalibration, saveCalibration, } from './storage';
4
+ export type { CalibrationStorage } from './storage';
5
+ export { useXRCalibration } from './useXRCalibration';
6
+ export type { UseXRCalibrationOptions, UseXRCalibrationResult } from './useXRCalibration';
@@ -0,0 +1,13 @@
1
+ import { XRCalibration } from './types';
2
+ export declare const CALIBRATION_STORAGE_KEY = "vincentt.xr.calibration";
3
+ /** The subset of `Storage` the persistence helpers use; `localStorage` fits. */
4
+ export type CalibrationStorage = Pick<Storage, "getItem" | "setItem" | "removeItem">;
5
+ /**
6
+ * Read a persisted calibration. Returns `null` when nothing is stored, the
7
+ * blob is corrupt, or it was written by another `version` (never throws).
8
+ */
9
+ export declare const loadCalibration: (key?: string, storage?: CalibrationStorage | null) => XRCalibration | null;
10
+ /** Persist a calibration. Returns `false` when storage is unavailable or full. */
11
+ export declare const saveCalibration: (calibration: XRCalibration, key?: string, storage?: CalibrationStorage | null) => boolean;
12
+ /** Remove the persisted calibration (no-op when storage is unavailable). */
13
+ export declare const clearCalibration: (key?: string, storage?: CalibrationStorage | null) => void;
@@ -0,0 +1,53 @@
1
+ import { FeedSourceKind, SourceOrientation } from '../coordinates/spaces';
2
+ /**
3
+ * Reference face measurements captured while the person stands at their
4
+ * "normal" distance. Units are feed-width fractions (0..1), the same space as
5
+ * `FaceInfo.landmarks`, so they survive a resize but not a lens change.
6
+ */
7
+ export type XRFaceCalibration = {
8
+ /** Temple-to-temple width (landmarks 234 ↔ 454). */
9
+ faceWidth: number;
10
+ /** Outer eye-corner distance (landmarks 33 ↔ 263). */
11
+ eyeDistance: number;
12
+ /** `performance.now()`-independent wall-clock stamp (ms since epoch). */
13
+ capturedAt: number;
14
+ };
15
+ /** Reference body proportions (feed-space fractions) for scaling body-anchored content. */
16
+ export type XRBodyCalibration = {
17
+ /** Shoulder-to-shoulder width (pose landmarks 11 ↔ 12). */
18
+ shoulderWidth: number;
19
+ /** Hip-to-hip width (pose landmarks 23 ↔ 24). */
20
+ hipWidth: number;
21
+ /** Mid-shoulder to mid-hip distance. */
22
+ torsoLength: number;
23
+ capturedAt: number;
24
+ };
25
+ /**
26
+ * Persistent device calibration. Nothing here changes what trackers report:
27
+ * it is applied only by `applyCalibrationToFeedPoint` and the derived helpers.
28
+ */
29
+ export type XRCalibration = {
30
+ /** Bump when the shape changes; `loadCalibration` drops other versions. */
31
+ version: 1;
32
+ /** Clockwise rotation the raw frame needs before use (a sideways capture). */
33
+ orientation: SourceOrientation;
34
+ /** `"auto"` mirrors exactly when the session mirrors (webcam); booleans force it. */
35
+ mirrored: boolean | "auto";
36
+ /** Uniform scale about the feed centre; 1 = none. */
37
+ scale: number;
38
+ /** Horizontal / vertical nudge in feed units after scaling (0 = none). */
39
+ offset: {
40
+ x: number;
41
+ y: number;
42
+ };
43
+ face: XRFaceCalibration | null;
44
+ body: XRBodyCalibration | null;
45
+ /** Wall-clock ms of the last change. */
46
+ updatedAt: number;
47
+ };
48
+ /** The fields `updateCalibration` accepts. */
49
+ export type XRCalibrationPatch = Partial<Pick<XRCalibration, "orientation" | "mirrored" | "scale" | "offset" | "face" | "body">>;
50
+ /** Resolved mirror decision for one source kind. */
51
+ export type XRCalibrationContext = {
52
+ sourceKind: FeedSourceKind;
53
+ };
@@ -0,0 +1,46 @@
1
+ import { FeedPoint, FeedSourceKind } from '../coordinates/spaces';
2
+ import { CalibrationStorage } from './storage';
3
+ import { XRCalibration, XRCalibrationPatch } from './types';
4
+ type Landmark = {
5
+ x: number;
6
+ y: number;
7
+ };
8
+ export type UseXRCalibrationOptions = {
9
+ /** Persist to storage under this key (default `"vincentt.xr.calibration"`). */
10
+ storageKey?: string;
11
+ /** `false` keeps the calibration in memory only. Default `true`. */
12
+ persist?: boolean;
13
+ /** Storage to use instead of `localStorage` (tests, custom backends). */
14
+ storage?: CalibrationStorage | null;
15
+ /** Starting values when nothing is persisted. */
16
+ initial?: XRCalibrationPatch;
17
+ };
18
+ export type UseXRCalibrationResult = {
19
+ calibration: XRCalibration;
20
+ /** True once the persisted value (if any) has been read. */
21
+ hydrated: boolean;
22
+ /** Merge a patch (and persist). Returns the new calibration. */
23
+ update: (patch: XRCalibrationPatch) => XRCalibration;
24
+ /** Back to defaults; clears the persisted value. */
25
+ reset: () => XRCalibration;
26
+ /** Capture the reference face from feed-space landmarks. Returns `false` without a face. */
27
+ calibrateFace: (landmarks: readonly Landmark[] | undefined) => boolean;
28
+ /** Capture the reference body from feed-space pose landmarks. Returns `false` without a body. */
29
+ calibrateBody: (landmarks: readonly Landmark[] | undefined) => boolean;
30
+ /** `applyCalibrationToFeedPoint` bound to this calibration and the session's source kind. */
31
+ applyToFeedPoint: (point: FeedPoint, target?: FeedPoint) => FeedPoint;
32
+ /** `estimateFaceDistance` bound to this calibration. */
33
+ faceDistance: (landmarks: readonly Landmark[] | undefined) => number | null;
34
+ /** `estimateBodyScale` bound to this calibration. */
35
+ bodyScale: (landmarks: readonly Landmark[] | undefined) => number | null;
36
+ /** The session's current source kind (what `"auto"` mirroring follows). */
37
+ sourceKind: FeedSourceKind;
38
+ };
39
+ /**
40
+ * Device calibration state: measure, persist, reset and apply. Raw tracker
41
+ * output is never altered; call `applyToFeedPoint` (or the estimate helpers)
42
+ * where you want calibrated values. Needs an `<XRProvider>` for the source
43
+ * kind that `mirrored: "auto"` follows.
44
+ */
45
+ export declare const useXRCalibration: (options?: UseXRCalibrationOptions) => UseXRCalibrationResult;
46
+ export {};
@@ -0,0 +1,26 @@
1
+ import { ReactNode } from 'react';
2
+ import { UseCameraPermissionResult } from './useCameraPermission';
3
+ export type CameraPermissionGateProps = {
4
+ /** Rendered once the camera is usable (`granted`). */
5
+ children: ReactNode;
6
+ /**
7
+ * Rendered in every other state. Receives the hook result so the fallback
8
+ * can show the state, the reason and a request button. Omit for the
9
+ * built-in accessible fallback.
10
+ */
11
+ fallback?: (permission: UseCameraPermissionResult) => ReactNode;
12
+ /** Prompt on mount instead of waiting for the button. Default `false`. */
13
+ auto?: boolean;
14
+ constraints?: MediaStreamConstraints;
15
+ /** Copy for the built-in fallback's button. */
16
+ requestLabel?: string;
17
+ };
18
+ /**
19
+ * Renders `children` only while camera access is `granted`; otherwise a
20
+ * fallback that explains the state and offers a request button. The
21
+ * built-in fallback announces state changes through `aria-live`, keeps the
22
+ * request behind a real button (a user gesture, as browsers require), and
23
+ * disables it when a prompt cannot help (`blocked`, `unavailable`). No camera
24
+ * frame is captured until the viewer allows access and the session binds.
25
+ */
26
+ export declare const CameraPermissionGate: ({ children, fallback, auto, constraints, requestLabel, }: CameraPermissionGateProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,26 @@
1
+ import { XRCameraFacing } from '../types/compositor';
2
+ /** One video input the browser lists. Labels are empty until camera permission is granted. */
3
+ export type XRCameraDevice = {
4
+ deviceId: string;
5
+ label: string;
6
+ /** Guessed from the label (`back`, `rear`, `environment` → rear; `front`, `user`, `facetime` → front); `null` when unknown. */
7
+ facing: XRCameraFacing | null;
8
+ };
9
+ export type XRCameraDeviceEnvironment = {
10
+ enumerateDevices?: () => Promise<Array<{
11
+ kind: string;
12
+ deviceId: string;
13
+ label: string;
14
+ }>>;
15
+ };
16
+ /** Guess a camera's facing from its label. */
17
+ export declare const guessCameraFacing: (label: string) => XRCameraFacing | null;
18
+ /**
19
+ * List the cameras the browser exposes. Before permission is granted most
20
+ * browsers return devices with empty labels (and some return none), so call
21
+ * it after `requestCameraAccess` / a first bind for a usable list. Never
22
+ * throws; an unsupported browser yields `[]`.
23
+ */
24
+ export declare const listCameras: (env?: XRCameraDeviceEnvironment) => Promise<XRCameraDevice[]>;
25
+ /** Pick the device for a facing from a list (first match), or `null`. */
26
+ export declare const findCameraByFacing: (cameras: XRCameraDevice[], facing: XRCameraFacing) => XRCameraDevice | null;
@@ -0,0 +1,8 @@
1
+ export { CAMERA_PERMISSION_MESSAGES, canPromptForCamera, classifyCameraFailure, queryCameraPermission, requestCameraAccess, subscribeCameraPermission, } from './permission';
2
+ export type { XRCameraAccessOptions, XRCameraAccessResult, XRCameraPermissionEnvironment, XRCameraPermissionQuery, XRCameraPermissionState, } from './permission';
3
+ export { useCameraPermission } from './useCameraPermission';
4
+ export type { UseCameraPermissionOptions, UseCameraPermissionResult } from './useCameraPermission';
5
+ export { CameraPermissionGate } from './CameraPermissionGate';
6
+ export { findCameraByFacing, guessCameraFacing, listCameras } from './devices';
7
+ export type { XRCameraDevice, XRCameraDeviceEnvironment } from './devices';
8
+ export type { CameraPermissionGateProps } from './CameraPermissionGate';
@@ -0,0 +1,86 @@
1
+ import { XRFallbackReason } from '../capabilities/types';
2
+ import { XRErrorReason } from '../hooks/useXRSession/reason';
3
+ /**
4
+ * Creator-facing camera permission state.
5
+ *
6
+ * - `unknown`: never asked (the next request will prompt), or the browser
7
+ * cannot say.
8
+ * - `requesting`: a `getUserMedia` prompt is open.
9
+ * - `granted`: usable; the session may bind the webcam.
10
+ * - `denied`: this request was declined or the prompt was dismissed; asking
11
+ * again will prompt again.
12
+ * - `blocked`: persistently denied in the browser's site settings; asking
13
+ * again will fail without a prompt, so the viewer must change the setting.
14
+ * - `unavailable`: no camera, insecure context, unsupported browser, or the
15
+ * device is held by another app (`reason` says which).
16
+ */
17
+ export type XRCameraPermissionState = "unknown" | "requesting" | "granted" | "denied" | "blocked" | "unavailable";
18
+ /** What the Permissions API can tell before any request. */
19
+ export type XRCameraPermissionQuery = {
20
+ state: "unknown" | "granted" | "blocked";
21
+ /** True when the browser reported `prompt` (it will ask on the next request). */
22
+ prompt: boolean;
23
+ };
24
+ export type XRCameraAccessResult = {
25
+ state: XRCameraPermissionState;
26
+ reason: XRFallbackReason | null;
27
+ /** The stream, only when `keepStream` was true and access was granted. */
28
+ stream: MediaStream | null;
29
+ };
30
+ export type XRCameraAccessOptions = {
31
+ /** Keep the granted stream open and return it. Default `false`: the probe stops every track at once. */
32
+ keepStream?: boolean;
33
+ /** Constraints for the probe (default `{ video: { facingMode: "user" } }`). */
34
+ constraints?: MediaStreamConstraints;
35
+ };
36
+ /** Minimal environment the helpers read, injectable for tests. */
37
+ export type XRCameraPermissionEnvironment = {
38
+ mediaDevices?: {
39
+ getUserMedia?: (constraints: MediaStreamConstraints) => Promise<MediaStream>;
40
+ };
41
+ permissions?: {
42
+ query: (desc: {
43
+ name: string;
44
+ }) => Promise<{
45
+ state: string;
46
+ addEventListener?: (type: "change", listener: () => void) => void;
47
+ removeEventListener?: (type: "change", listener: () => void) => void;
48
+ }>;
49
+ };
50
+ isSecureContext?: boolean;
51
+ };
52
+ export declare const defaultCameraEnvironment: () => XRCameraPermissionEnvironment;
53
+ /**
54
+ * Ask the Permissions API for the camera state without prompting. `unknown`
55
+ * covers both "will prompt" (`prompt: true`) and "cannot tell" (Firefox and
56
+ * older Safari reject the camera descriptor).
57
+ */
58
+ export declare const queryCameraPermission: (env?: XRCameraPermissionEnvironment) => Promise<XRCameraPermissionQuery>;
59
+ /**
60
+ * Turn a failed `getUserMedia` (its SDK reason) plus the permission state
61
+ * read *after* the failure into a creator-facing state. A denial while the
62
+ * browser now reports `denied` is a persistent block; a denial while it still
63
+ * reports `prompt` was a dismissal or a one-off decline.
64
+ */
65
+ export declare const classifyCameraFailure: (reason: XRErrorReason, permission: XRCameraPermissionQuery["state"]) => {
66
+ state: XRCameraPermissionState;
67
+ reason: XRFallbackReason;
68
+ };
69
+ /**
70
+ * Request camera access explicitly, before (or outside) a session. The
71
+ * granted stream is stopped immediately unless `keepStream` is set, so the
72
+ * camera indicator goes off and no frame is processed: this only moves the
73
+ * permission. Pass the returned stream to `session.setMediaSource` when you
74
+ * keep it. Never throws; read `state` and `reason`.
75
+ */
76
+ export declare const requestCameraAccess: (options?: XRCameraAccessOptions, env?: XRCameraPermissionEnvironment) => Promise<XRCameraAccessResult>;
77
+ /**
78
+ * Subscribe to Permissions API changes (the viewer toggling the site's camera
79
+ * setting). The listener receives the new query; returns an unsubscribe.
80
+ * Resolves to a no-op where the API is unavailable.
81
+ */
82
+ export declare const subscribeCameraPermission: (listener: (query: XRCameraPermissionQuery) => void, env?: XRCameraPermissionEnvironment) => Promise<() => void>;
83
+ /** True when a request can show a prompt or succeed (not blocked / unavailable). */
84
+ export declare const canPromptForCamera: (state: XRCameraPermissionState) => boolean;
85
+ /** Display copy per state (reword freely; branch on `state`, never on this text). */
86
+ export declare const CAMERA_PERMISSION_MESSAGES: Record<XRCameraPermissionState, string>;
@@ -0,0 +1,35 @@
1
+ import { XRFallbackReason } from '../capabilities/types';
2
+ import { XRCameraAccessOptions, XRCameraPermissionEnvironment, XRCameraPermissionState } from './permission';
3
+ export type UseCameraPermissionOptions = {
4
+ /** Request on mount (shows the prompt immediately). Default `false`: query only, prompt on `request()`. */
5
+ auto?: boolean;
6
+ /** Probe constraints passed to `requestCameraAccess`. */
7
+ constraints?: MediaStreamConstraints;
8
+ /** Environment override for tests. */
9
+ env?: XRCameraPermissionEnvironment;
10
+ };
11
+ export type UseCameraPermissionResult = {
12
+ state: XRCameraPermissionState;
13
+ reason: XRFallbackReason | null;
14
+ /** The next `request()` can show a prompt or succeed. */
15
+ canPrompt: boolean;
16
+ /** `granted`. */
17
+ usable: boolean;
18
+ /**
19
+ * Prompt (or re-prompt). Resolves to the new state. The probe stream is
20
+ * always stopped at once; to keep a stream, call `requestCameraAccess`
21
+ * directly, which returns it.
22
+ */
23
+ request: (options?: Pick<XRCameraAccessOptions, "constraints">) => Promise<XRCameraPermissionState>;
24
+ /** Re-read the Permissions API without prompting. */
25
+ refresh: () => Promise<XRCameraPermissionState>;
26
+ };
27
+ /**
28
+ * Camera permission for a landing or gate screen. Needs no `<XRProvider>`.
29
+ * Queries on mount (never prompts unless `auto`), follows the browser's
30
+ * site-setting changes, and exposes `request()` for a user-gesture button.
31
+ * Once `usable`, mount the session and call `setMediaSource({ source:
32
+ * XRMediaSource.WEBCAM })`; the session reports its own live state through
33
+ * `useXRSessionCameraPermission()` (`/low-level`).
34
+ */
35
+ export declare const useCameraPermission: (options?: UseCameraPermissionOptions) => UseCameraPermissionResult;
@@ -0,0 +1,9 @@
1
+ import { F as A, a as C } from "./uv-DJU_XfmN.js";
2
+ const a = 468, N = Uint16Array.from(A.flat()), o = Float32Array.from(
3
+ C.slice(0, a * 2)
4
+ );
5
+ export {
6
+ a as C,
7
+ o as a,
8
+ N as b
9
+ };
@@ -0,0 +1 @@
1
+ "use strict";const A=require("./uv-BMFt19bg.cjs"),C=468,N=Uint16Array.from(A.FACE_MESH_INDICES.flat()),_=Float32Array.from(A.FACE_MESH_UV.slice(0,C*2));exports.CANONICAL_FACE_LANDMARK_COUNT=C;exports.CANONICAL_FACE_TRIANGLES=N;exports.CANONICAL_FACE_UVS=_;