@vincentt-xr/sdk 2.0.0-alpha.0 → 2.0.0-alpha.10

package/dist/entries/low-level.d.ts

@@ -6,25 +6,123 @@
  * blessed API can't express this." Prefer `/tracking` and `/face-effects`
  * first; reach here only when they fall short.
  */
-export { useXRContext } from '../components';
+export { useXRContext } from '../components/XRProvider';
 export { useTrackerContext } from '../hooks/useTrackerContext';
 export type { TrackerContextValue, TrackerLandmarkResolver } from '../hooks/useTrackerContext';
 export { useXRModel } from '../hooks/useXRModel';
 export type { UseXRModelResult } from '../hooks/useXRModel';
-export type { XRModelNodeSegmentation, XRModelNodeBodyTracking, XRModelNodeHandTracking, XRModelNodeGestureTracking, XRModelNodeFaceTracking, } from '../types/nodes';
-export { useXRReady, useXRError, useXRCameraTexture, useXRRenderSize, useXRModelNode, useXRPipelineSnapshot, } from '../hooks/selectors';
+export type { XRModelNodeSegmentation, XRModelNodeBodyTracking, XRModelNodeHandTracking, XRModelNodeGestureTracking, XRModelNodeFaceTracking, XRModelNodeHolisticTracking, } from '../types/nodes';
+export { useXRReady, useXRError, useXRLifecycle, useXRModelErrors, useXRTrackerStatus, useXRSessionCameraPermission, useXRCameraFacing, useXRCameraDeviceId, useXRMirrored, useXROrientation, useXRQualityState, useXRQualityConfig, sessionReasonToFallback, useXRCameraTexture, useXRRenderSize, useXRFeedCrop, useXRFeedAspect, useXRModelNode, useXRPipelineSnapshot, } from '../hooks/selectors';
+export type { XRCameraPermission, XRTrackerStatus } from '../hooks/selectors';
+export type { SessionLifecycleState, XRModelError, XRSessionError, } from '../hooks/useXRSession/store';
+export type { XRErrorReason } from '../hooks/useXRSession/reason';
+export { mapDomExceptionToReason } from '../hooks/useXRSession/reason';
+export { classifyCameraFailure } from '../camera';
+export type { XRCameraFacing, XRCameraRequest, XROrientation, XRSessionSourceKind, } from '../types/compositor';
+export type { ModelRegistryState } from '../hooks/useXRSession/registry';
+export { useXRDiagnostics, sampleXRDiagnostics, XR_MODEL_LABELS } from '../hooks/useXRDiagnostics';
+export type { UseXRDiagnosticsOptions, XRDiagnostics, XRModelDiagnosticsEntry, XRSessionDiagnostics, } from '../hooks/useXRDiagnostics';
+export type { XRModelDiagnostics } from '../models/Base';
+export { mapModelErrorToReason, permissionStateToStatus } from '../capabilities';
+export { COMPAT_SCENARIOS, MANUAL_COMPAT_SCENARIOS, classifyCompatCause, createCompatReport, describeCompatEnvironment, findCompatScenario, parseUserAgent, runCompatChecks, summarizeCompatResults, } from '../compat';
+export type { XRCompatAutomatedScenarioId, XRCompatCause, XRCompatEnvironment, XRCompatManualScenarioId, XRCompatScenarioId, XRCompatReport, XRCompatResult, XRCompatRunOptions, XRCompatScenario, XRCompatStatus, } from '../compat';
+export { EMPTY_QUALITY_SIGNALS, createQualityState, judgeSample, lockQuality, readDeviceSignals, resetQuality, resolveInitialTierIndex, resolvePerformanceBudget, resolveQualityTier, setQualityTier, stepQualityController, tierToApply, } from '../quality';
 export type { GestureName } from '../hooks/useGestureEdge';
+export { createGestureDetectorState, gestureStatesEqual, snapshotGestureState, stepGestureDetector, HAND_JOINTS, OscillationTracker, POSE_JOINTS, measureArmRaise, measureFingerPattern, measureGrab, measureHandHeight, measureOpenPalm, measurePinch, measureTPose, measureThumb, fingerExtensions, thumbDirection, thumbExtension, } from '../gestures';
+export type { FingerPattern, GestureDetectorState } from '../gestures';
+export { BODY_POSE_TRIGGER_DEFAULTS, TimedSeries, bodyTriggerStatesEqual, createBodyMoveFrame, createBodyTrigger, resolveBodyMoveLimits, resolveBodyTriggerOptions, setBodyTriggerOptions, sideJoint, snapshotBodyTriggerState, stepBodyTrigger, } from '../body-trigger';
+export type { BodyTriggerMachine, CreateBodyMoveFrameOptions } from '../body-trigger';
+export { IRIS_FULL_OPENNESS, IrisLead, computeIrisEye, createIrisEye, createIrisResult, updateIrisResult, } from '../iris';
 export { useFaceBoundingBox } from '../hooks/useFaceBoundingBox';
 export { computeLandmarkBounds } from '../utils/landmarkBounds';
-export { useScreenSpace, ScreenRectAspectContext, computeScreenTransform } from '../components';
+export { createFaceInfoTarget, getFaceInfo } from '../face-info';
+export type { FaceInfoTarget } from '../face-info';
+export { useScreenSpace, ScreenRectAspectContext, computeScreenTransform, } from '../components/ScreenSpaceUI';
 export type { ScreenAnchorEdges, ScreenOffsetEdges, ResolvedScreenTransform, ScreenDimensions, } from '../components/ScreenSpaceUI';
-export { XRCompositor, XRLayer, XRMediaSurface, XRViewport, XRTrackingOverlay, useXRViewportState, PerspectiveCamera, HeadTracker, BoundingBoxOverlay, } from '../components';
-export type { BoundingBoxOverlayProps } from '../components';
+export { XRCompositor } from '../components/XRCompositor';
+export { XRLayer } from '../components/XRLayer';
+export { XRMediaSurface, XRTrackingOverlay } from '../components/XRMediaSurface';
+export { XRViewport, useXRViewportState } from '../components/XRViewport';
+export { PerspectiveCamera } from '../components/PerspectiveCamera';
+export { HeadTracker, BoundingBoxOverlay } from '../components/FaceTracker';
+export type { BoundingBoxOverlayProps } from '../components/FaceTracker';
 export type { XRViewportFitMode, XRViewportMediaAssetOption, XRViewportMediaStrategy, XRViewportMode, XRViewportRenderState, XRViewportSize, XRViewportSourceConfig, XRViewportSourceKind, } from '../components/XRViewport';
 export type { XRLayerConfig } from '../types/compositor';
 export type { XRMediaLayout, XRMediaSourceKind } from '../types/compositor';
+export { useXRViewportRenderOutputs } from '../components/XRViewport';
+export type { XRViewportPreviewMode, XRViewportRenderOutputRequest, XRViewportRenderOutputs, } from '../components/XRViewport';
+export type { XRSceneRenderOutputRequest, XRSceneRenderOutputs } from '../components/XRScene';
+export { getThreeBlending, getThreeDepthFunction, getThreeSide } from '../components/MeshRenderer';
 export { resolveCalibrationFaceDisplayMirrored, useCalibrationFaceTracker, } from '../hooks/useCalibrationFaceTracker';
 export type { CalibrationMediaSourceKind, CalibrationTrackerMode, } from '../hooks/useCalibrationFaceTracker';
 export type { TextureFit } from '../texture/types';
 export { TEXTURE_FITS } from '../texture/types';
 export { hasFullUnitUVBounds } from '../texture/hasFullUnitUVBounds';
+export { getPlaybackFrame, getSequenceFrame } from '../texture/animationMath';
+export type { PlaybackFrameResult } from '../texture/animationMath';
+export { BasicAnimatedTextureController } from '../texture/animatedTexture';
+export { gifTextureSourceProvider } from '../texture/gifTextureSource';
+export { MAX_GIF_BYTES, MAX_GIF_FRAMES, MAX_GIF_PIXELS } from '../texture/gifTextureSource';
+export type { GifTextureSource } from '../texture/gifTextureSource';
+export type { AnimatedTextureCapabilities, AnimatedTextureController, AnimatedTextureListener, AnimatedTextureEvent, AnimatedTextureEventListener, AnimatedTextureEventType, AnimatedTexturePlayMode, AnimatedTextureSnapshot, AnimatedTextureState, } from '../texture/animatedTexture';
+export { TextureSourceLoadError, createTextureSourceResolver, disposeResolvedTextureSource, resolveTextureSource, throwIfAborted, } from '../texture/sourceResolver';
+export type { ResolvedTextureSource, TextureSourceProvider, TextureSourceResolver, } from '../texture/sourceResolver';
+export { MAX_OVERLAY_LABELS, SEGMENTATION_OVERLAY_FRAGMENT_SHADER, SEGMENTATION_OVERLAY_VERTEX_SHADER, createSegmentationOverlayMaterial, resolveActiveOverlayLabelIndices, resolveOverlayLabelIndices, updateSegmentationOverlayMaterial, useSegmentationOverlayMaterial, createSemanticMaskTexture, uploadSemanticMask, useSemanticMaskTexture, resolveMaskSize, } from '../components/SegmentationOverlay';
+export type { SegmentationOverlayMaterialInputs } from '../components/SegmentationOverlay';
+export { FACE_REGION_POLYGONS, computeMaskUvTransform, fillLandmarkPolygon, fillPolygon, rasterizeFaceRegions, semanticMaskLabelIndex, } from '../segmentation2d';
+export type { MaskUvTransformInput, RasterizeFaceRegionsOptions } from '../segmentation2d';
+export { HAND_RIG_BONES, HAND_RIG_KNUCKLE_SHIFT, HAND_RIG_LENGTH_RANGE, HAND_RIG_PALM_JOINTS, HAND_RIG_SNAP_PALMS, applyHandRigLengths, handAttachmentLocal, applyHandRigSolution, bindHandRig, handRigRootMatrix, handRigSnapDistance, screenChirality, solveHandRig, } from '../hand/handRigSolver';
+export type { HandAttachmentTransform, HandRigBinding, HandRigSolution, } from '../hand/handRigSolver';
+export { HAND_RIG_MODEL_MESH, HandRigContext } from '../components/HandRig';
+export { BODY_RIG_BONE_REGION, BODY_RIG_FOREARM_TWIST_SHARE, BODY_RIG_HAND_SEEN, BODY_RIG_HEAD_LIMITS, BODY_RIG_HINGE_BEND, BODY_RIG_NECK_SHARE, BODY_RIG_REGIONS, BODY_RIG_REGION_JOINTS, applyBodyRigSolution, bindBodyRig, limitHeadTurn, resetBodyRig, solveBodyRig, } from '../body/bodyRigSolver';
+export type { BodyRigBinding, BodyRigRegion, BodyRigSolution } from '../body/bodyRigSolver';
+export { BODY_RIG_CHEST_RANGE, BODY_RIG_CLAVICLE_RANGE, BODY_RIG_EAR_TO_HEAD, BODY_RIG_HEAD_ABOVE_EARS, BODY_RIG_HEAD_CENTER, BODY_RIG_HEAD_RANGE, BODY_RIG_LENGTH_RANGE, BODY_RIG_LIMBS, BODY_RIG_LIMB_BONES, BODY_RIG_LIMB_JOINTS, BODY_RIG_NECK_RANGE, BODY_RIG_SEGMENTS, BODY_RIG_SHOULDER_TO_TORSO, applyBodyRigHeadScale, applyBodyRigLengths, bodyPoseToScene, bodyRigChestScale, bodyRigClipPose, bodyRigJointPosition, bodyRigHeadCenter, bodyRigHeadScale, bodyRigHeadTarget, bodyRigLengthRatios, bodyRigModelHead, bodyRigSceneScale, bodyRigShoulderScale, reachBodyRigHead, reachBodyRigLimb, } from '../body/bodyRigFit';
+export type { BodyRigLimb, BodyRigModelHead, BodyRigSegment, BodySceneJoints, } from '../body/bodyRigFit';
+export { BODY_FLIP_GUARD_DEFAULTS, BodyFlipGuard } from '../body/bodyFlipGuard';
+export type { BodyFlipGuardSettings } from '../body/bodyFlipGuard';
+export { BODY_IDENTITY_DEFAULTS, BodyIdentity, resolveNumBodies } from '../body/bodyIdentity';
+export type { BodyIdentitySettings } from '../body/bodyIdentity';
+export { bodySubjectCount, resolveBody } from '../body/bodySubject';
+export { SKINNED_OCCLUDER_RENDER_ORDER, createSkinnedOccluderMaterial, patchOccluderInflate, useSkinnedOccluder, } from '../components/occluder/skinnedOccluder';
+export type { SkinnedOccluderOptions } from '../components/occluder/skinnedOccluder';
+export { BODY_MASK_BONES, BODY_MASK_MAX_PEOPLE, BODY_MASK_MIN_VISIBILITY, BODY_MASK_SPLIT_DEFAULTS, bodyMaskDistance, bodyMaskPerson, bodyMaskWeights, closestBodies, packBodyMaskUniforms, splitBodyMask, } from '../body/bodyMask';
+export type { BodyMaskPerson, BodyMaskSnapshot, BodyMaskSplitOptions, BodyMaskUniforms, } from '../body/bodyMask';
+export { createBodyMaskSplitMaterial, setBodyMaskSplitUniforms } from '../body/bodyMaskMaterial';
+export { createHandOccluderMaterial, patchHandOccluderInflate, } from '../components/HandRig/HandOccluder';
+export { bodyAttachmentFrame } from '../components/BodyRig/BodyAttachment';
+export { BODY_DEPTH_LAYER, BODY_DEPTH_RANGE_PAD, bodyDepthRange, createBodyDepthMaterial, patchBodyDepthShaders, renderBodyDepth, } from '../components/BodyRig/bodyDepth';
+export { HAND_TATTOO_FACING_FADE, handGeometryToRoot, handTattooFrame, handTattooMatrix, handTattooUv, } from '../hand/handTattoo';
+export type { HandTattooFrame, HandTattooLook, HandTattooPlacementOptions, } from '../hand/handTattoo';
+export { createHandTattooMaterial, setHandTattooBlend } from '../components/HandRig/HandTattoo';
+export { HAND_NAIL_FACING_FADE, HAND_NAIL_FINISH_LIGHTING, handNailCoverage, handNailDistance, handNailFrame, } from '../hand/handNail';
+export type { HandNailFrame, HandNailFrameOptions } from '../hand/handNail';
+export { refineNailTip } from '../hand/nailTipRefine';
+export { DEFAULT_NAIL_FALLBACK, paintFallbackNail, settleNailMask } from '../hand/nailImageMask';
+export type { NailFingerQuery, NailMaskGrid } from '../hand/nailImageMask';
+export { assignNailBlobs } from '../hand/nailMaskFingers';
+export type { NailBlobTip } from '../hand/nailMaskFingers';
+export type { NailTipRefineOptions, NailTipRefinement } from '../hand/nailTipRefine';
+export { createHandNailsMaterial } from '../components/HandRig/HandNails';
+export { wristFrameLocal } from '../hand/wrist';
+export { FOREARM_BULGE_AT, FOREARM_ELBOW_DEPTH_OF_WRIST, FOREARM_ELBOW_WIDTH_OF_WRIST, FOREARM_LENGTH_OF_HAND, WRIST_JOINT_LIMITS, clampWristBend, forearmDirectionOf, forearmSectionAt, forearmSegmentOf, handLengthOf, limitForearmDirection, wristBendOf, } from '../hand/forearm';
+export type { ForearmSegment, WristBend } from '../hand/forearm';
+export { elbowUpOnScreen } from '../components/HandRig';
+export { ARM_MASK_DEFAULTS, armQueryOf, measureArm } from '../hand/armMask';
+export type { ArmMaskSource, ArmMeasure, ArmMeasureOptions, ArmQuery, ArmSection, FeedVec, } from '../hand/armMask';
+export { useArmMask } from '../components/HandRig/useArmMask';
+export { ARM_FIT_DEFAULTS, ArmTracker } from '../hand/armMask';
+export type { ArmFitSettings } from '../hand/armMask';
+export { ellipseWidthOnScreen, fitWristFrame, frameUpOnScreen, screenAngle, worldToFeedUnits, } from '../hand/armFit';
+export type { WristFitTarget } from '../hand/armFit';
+export { HAND_RIG_FOREARM, HandRigWrist, HandRigWristContext, ensureForearmBone, } from '../components/HandRig';
+export type { HandRigArm, HandRigArmMaskOptions } from '../components/HandRig';
+export { WRIST_FILTER_DEFAULTS, WristRotationFilter } from '../hand/wristFilter';
+export type { WristFilterSettings } from '../hand/wristFilter';
+export type { ArmMask, ArmMaskKind } from '../components/HandRig/useArmMask';
+export type { WristFrame } from '../hand/wrist';
+export { TouchWorld, createTouchHand, updatePointerHand, updateTouchHand } from '../hand/handTouch';
+export { HandTouchContext } from '../components/HandTouch';
+export { anatomicalHandedness, assignHandPoses, handWorldLandmarkToJoint } from '../hand/handPose';
+export { BODY_JOINT_OTHER_SIDE, anatomicalBodyPose, bodyWorldLandmarkToJoint, } from '../body/bodyPose';
+export type { BodyDetection } from '../body/bodyPose';
+export type { AssignHandPosesOptions, HandDetection } from '../hand/handPose';

package/dist/entries/particles.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@vincentt-xr/sdk/particles` — GPU particles. `<ParticleEmitter>` emits
+ * from wherever it is placed (inside a tracker to follow a face or a hand);
+ * each particle's spawn record is written once and the vertex shader works
+ * out the rest (stateless on the GPU). The settings, the CPU reference of
+ * the shader and the system class are here for custom emitters.
+ */
+export { ParticleEmitter } from '../components/ParticleEmitter';
+export type { ParticleEmitterProps } from '../components/ParticleEmitter';
+export { HandEffect } from '../components/HandEffect';
+export type { HandEffectHand, HandEffectProps } from '../components/HandEffect';
+export { DEFAULT_HAND_EFFECT_MOTION, HAND_EFFECT_SOURCES, HAND_UNIT_JOINTS, handEffectIsCentred, handEffectJoints, handEffectRate, handUnitPerCm, } from '../hand/handEffect';
+export type { HandEffectMotion, HandEffectSource } from '../hand/handEffect';
+export { DEFAULT_PARTICLE_SETTINGS, PARTICLE_BLENDINGS, PARTICLE_EMITTER_TARGETS, PARTICLE_EYE_CENTRE, PARTICLE_EYE_FORWARD, PARTICLE_DRAG_SERIES_LIMIT, PARTICLE_FRAGMENT_SHADER, PARTICLE_MAX_COLORS, PARTICLE_MAX_PARTICLES, PARTICLE_MAX_STEP, PARTICLE_PRESETS, PARTICLE_PRESET_KEYS, PARTICLE_RECORD, PARTICLE_RECORD_FLOATS, PARTICLE_SETTINGS_RANGES, PARTICLE_SHAPES, PARTICLE_SPRITES, PARTICLE_STATE_GLSL, PARTICLE_VERTEX_SHADER, ParticleRing, ParticleSpawner, ParticleSystem, applyParticleUniforms, createParticleEmission, createParticleRandom, createParticleRecord, createParticleSample, createParticleStart, createParticleUniforms, isParticlePreset, parseParticleColor, particleAcceleration, particleCapacity, particleColorAt, particleDragAcceleration, particleDragDistance, particleEyePosition, particleOverLife, particlePresetBase, particleTargetSides, particleUnitOf, resolveParticleSettings, sampleParticle, sampleParticleCone, sampleParticleStart, spawnParticles, stepParticleEmission, } from '../particles';
+export type { ParticleBlending, ParticleColor, ParticleEmitterTarget, ParticleEmission, ParticleOverLife, ParticlePreset, ParticleRandom, ParticleRecord, ParticleSample, ParticleSettings, ParticleShape, ParticleSlotRange, ParticleSpawnFrame, ParticleSprite, ParticleStart, ParticleUniforms, ResolvedParticleSettings, } from '../particles';

package/dist/entries/product.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@vincentt-xr/sdk/product` — surface-placement ("view in your space") AR
+ * for product pages, built on Google's `<model-viewer>` (an optional peer
+ * dependency, loaded lazily). This is a separate mode from the SDK's camera
+ * session: placement AR hands the camera to WebXR / Scene Viewer / Quick
+ * Look; face and body tracking is the session. `useProductAr` manages the
+ * handoff when both exist on one page.
+ */
+export { DEFAULT_PRODUCT_AR_MODES, ProductDimensions, ProductHotspot, ProductViewer, dimensionLines, formatLength, hotspotAttributes, nextHotspotId, parseHotspots, serializeHotspots, useDimensionLines, useProductDimensions, useProductHotspots, useProductVariants, isModelViewerDefined, loadModelViewer, releaseSessionForAr, supportedProductArModes, useProductAr, } from '../product';
+export type { DimensionLine, ProductDetailsElement, ProductDimensionsData, ProductDimensionsProps, ProductHotspotData, ProductHotspotProps, UseProductHotspotsOptions, UseProductHotspotsResult, Vec3, ProductArMode, ProductArState, ProductArStatus, ProductViewerElement, ProductViewerPlacement, ProductViewerProps, ProductViewerScale, UseProductArOptions, UseProductArResult, } from '../product';
+export type { XRPlacementCapability } from '../capabilities';

package/dist/entries/scene-object.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `@vincentt-xr/sdk/scene-object` — public scene authoring data and pure store operations.
+ *
+ * Runtime renderers remain in the core door. DOM authoring panels remain in
+ * `@vincentt-xr/sdk/debug-ui`.
+ */
+export { addComponentToObject, componentDefaults, createDefaultComponent, createDefaultFaceMeshRendererSettings, createDefaultMaterialSettings, createDefaultMeshRendererSettings, createDefaultScreenImageSettings, createDefaultScreenTextSettings, createDefaultScreenShapeSettings, createDefaultScreenTransformSettings, createDefaultTextureSettings, createDefaultTransformSettings, createSceneComponentId, createSceneId, createSceneObject, createSceneObjectId, createOrderedComponentsSelector, deleteSceneObject, getOrderedComponents, getSceneObjectChildren, moveComponent, removeComponent, replaceSceneComponent, replaceSceneObject, setSceneObjectParent, setSceneObjectParentPreserveWorldTransform, setSceneObjectVisible, } from '../scene-object';
+export type { ComponentRegistry, MaterialSettings, SceneComponent, SceneComponentId, SceneComponentType, SceneObject, SceneObjectId, SceneObjectStore, TextureSettings, } from '../scene-object';
+export { createRenderPlan, DEFAULT_RENDER_GROUP_IDS, getDefaultRenderGroupId, migrateToRenderGroups, moveObjectToGroup, RENDER_GROUP_POLICIES, reorderObjectWithinGroup, reorderRenderGroup, validateGroupCompatibility, } from '../render/renderGroups';
+export type { RenderGroup, RenderGroupDomain, RenderGroupId, RenderGroupPolicy, RenderGroupSceneObjectStore, RenderMode, RenderPlanEntry, } from '../render/renderGroups';

package/dist/entries/tracking.d.ts

@@ -6,10 +6,118 @@
  * blessed face reader. Deep face-filter config lives in `/face-effects`; raw
  * model-node reads and selectors live in `/low-level`.
  */
-export { FaceTracker, HandTracker, GestureTracker, BodyTracker, Segmentation, FaceMesh, TrackingAnchor, GestureTrigger, } from '../components';
+export { FaceTracker } from '../components/FaceTracker';
+export { HandTracker } from '../components/HandTracker';
+export { GestureTracker } from '../components/GestureTracker';
+export { BODY_LANDMARK_INDEX, BodyTracker, bodyLandmarkIndex } from '../components/BodyTracker';
+export { HandRig } from '../components/HandRig';
+export type { HandRigProps } from '../components/HandRig';
+export { SDK_MODEL_PATHS, sdkModelAsset, sdkModelUrl } from '../assets/sdkModels';
+export type { SdkModel } from '../assets/sdkModels';
+export { BODY_RIG_DEFAULT_SMOOTHING, BODY_RIG_END_MARGIN, BODY_RIG_FRAME_PRIORITY, BODY_RIG_HIP_MARGIN, BODY_RIG_HOLD_MS, BODY_RIG_MODEL_MESH, BodyRig, BodyRigContext, } from '../components/BodyRig';
+export type { BodyRigProps } from '../components/BodyRig';
+export { BODY_OCCLUDER_RENDER_ORDER, BodyOccluder } from '../components/BodyRig/BodyOccluder';
+export type { BodyOccluderProps } from '../components/BodyRig/BodyOccluder';
+export { BodyAttachment } from '../components/BodyRig/BodyAttachment';
+export type { BodyAttachmentProps } from '../components/BodyRig/BodyAttachment';
+export { useBodyDepthTexture } from '../components/BodyRig/useBodyDepthTexture';
+export type { BodyDepthTexture, BodyDepthTextureOptions, BodyDepthUniforms, } from '../components/BodyRig/useBodyDepthTexture';
+export { BODY_DEPTH_GLSL } from '../components/BodyRig/bodyDepth';
+export { HandAttachment } from '../components/HandRig/HandAttachment';
+export type { HandAttachmentProps } from '../components/HandRig/HandAttachment';
+export { WristAttachment } from '../components/HandRig/WristAttachment';
+export type { WristAttachmentProps } from '../components/HandRig/WristAttachment';
+export { ForearmOccluder, createForearmGeometry } from '../components/HandRig/ForearmOccluder';
+export type { ForearmOccluderOptions, ForearmOccluderProps, } from '../components/HandRig/ForearmOccluder';
+export { FOREARM_OCCLUDER_FLARE, FOREARM_OCCLUDER_LENGTH, FOREARM_OCCLUDER_OVERLAP, WRIST_DEPTH_OF_WIDTH, WRIST_WIDTH_OF_PALM, wristSizeOf, } from '../hand/wrist';
+export type { WristSize } from '../hand/wrist';
+export { HAND_OCCLUDER_RENDER_ORDER, HandOccluder } from '../components/HandRig/HandOccluder';
+export type { HandOccluderProps } from '../components/HandRig/HandOccluder';
+export { HandTattoo } from '../components/HandRig/HandTattoo';
+export type { HandTattooBlend, HandTattooProps } from '../components/HandRig/HandTattoo';
+export { HAND_TATTOO_DEFAULT_SIZE, HAND_TATTOO_RENDER_ORDER } from '../hand/handTattoo';
+export type { HandTattooPlacement } from '../hand/handTattoo';
+export { HandNails } from '../components/HandRig/HandNails';
+export { HandRigHandContext } from '../components/HandRig';
+export type { HandNailsProps } from '../components/HandRig/HandNails';
+export { HAND_NAIL_FINGERS, HAND_NAIL_FINISHES, HAND_NAIL_RENDER_ORDER, HAND_NAIL_SHADES, HAND_NAIL_SHAPES, } from '../hand/handNail';
+export type { HandNailFinger, HandNailFinish, HandNailShade, HandNailShape, } from '../hand/handNail';
+export { HandCutout } from '../components/HandCutout';
+export type { HandCutoutProps } from '../components/HandCutout';
+export { HAND_CUTOUT_TRIANGLES, writeHandCutout } from '../hand/handCutout';
+export type { HandCutoutOptions } from '../hand/handCutout';
+export { HAND_TOUCH_DEPTH, HAND_TOUCH_POINTER_RADIUS, HandTouch, Touchable, useHandTouch, } from '../components/HandTouch';
+export type { HandTouchContextValue, HandTouchProps, TouchableProps, TouchableState, } from '../components/HandTouch';
+export { HAND_TOUCH_DEFAULTS, HAND_TOUCH_TIPS, TOUCH_WORLD_DEFAULTS } from '../hand/handTouch';
+export type { HandTouchPart, HandTouchSettings, HandTouchTip, TouchBody, TouchBodyOptions, TouchEvent, TouchHand, TouchHandId, TouchShape, TouchSphere, TouchWorldSettings, } from '../hand/handTouch';
+export type { HandAttachmentJoint } from '../hand/handRigSolver';
+export { HAND_JOINT_INDEX, HAND_JOINT_NAMES, HAND_POSE_DEFAULT_HOLD_MS } from '../hand/handPose';
+export type { HandJointName, HandPose, HandPoses } from '../hand/handPose';
+export { HAND_RIG_REQUIRED_JOINTS, handPoseToScene } from '../hand/handRigSolver';
+export { BODY_JOINT_INDEX, BODY_JOINT_NAMES } from '../body/bodyPose';
+export type { BodyJointName, BodyPose } from '../body/bodyPose';
+export type { TrackedBody } from '../body/bodyIdentity';
+export type { BodySubjectOptions, ResolvedBody } from '../body/bodySubject';
+export { useBodyIds, useBodySubject } from '../hooks/useBodies';
+export { useBodyMaskTexture } from '../components/PersonCutout/useBodyMaskTexture';
+export type { BodyMaskTextureOptions, BodyMaskTextureResult, } from '../components/PersonCutout/useBodyMaskTexture';
+export { BODY_RIG_BONES, BODY_RIG_MIXAMO_NAMES, BODY_RIG_REQUIRED_BONES, } from '../body/bodyRigSolver';
+export type { BodyRigBone } from '../body/bodyRigSolver';
+export { CANONICAL_TORSO_FIT_DEFAULT_SMOOTHING, CanonicalTorsoFrame, SHOULDER_OCCLUDER_DEFAULT_OPACITY, SHOULDER_OCCLUDER_V1_PATH, ShoulderOccluder, shoulderOccluderUrl, useCanonicalTorsoFit, } from '../components/ShoulderOccluder';
+export type { CanonicalTorsoFitOptions, CanonicalTorsoFrameProps, ShoulderOccluderProps, } from '../components/ShoulderOccluder';
+export { CANONICAL_SHOULDER_DISTANCE, CANONICAL_TORSO_INDICES, CANONICAL_TORSO_LANDMARKS, CANONICAL_TORSO_POINTS, solveShoulderPose, } from '../utils/shoulderOccluderFit';
+export { HolisticTracker, useHolisticTracking, getHolisticSignals, createHolisticSignals, isHandRaised, isPalmOpen, DEFAULT_HOLISTIC_SIGNAL_THRESHOLDS, DEFAULT_HOLISTIC_TRACKER_SETTINGS, DEFAULT_HOLISTIC_MODEL_URL, DEFAULT_HOLISTIC_HOLD_MS, DEFAULT_HOLISTIC_PREDICT_MS, DEFAULT_HOLISTIC_ANALYSIS_MAX_DIMENSION, HOLISTIC_HANDS_OPTIONS, HOLISTIC_TRACKER_SETTINGS_FIELDS, resolveHolisticTrackerSettings, patchHolisticTrackerSettings, toHolisticTrackerProps, } from '../components/HolisticTracker';
+export type { HolisticHandProps, HolisticSignalThresholds, HolisticSignals, HolisticTrackerProps, HolisticTrackerSettings, HolisticTrackingContextValue, } from '../components/HolisticTracker';
+export type { HolisticFaceResult, HolisticHandResult, HolisticHandSide, HolisticHandsOption, HolisticModelOptions, HolisticPoseResult, HolisticResult, HolisticRuntimeOptions, HolisticTrackingStatus, } from '../types/holistic';
+export { Segmentation } from '../components/Segmentation';
+export { FaceMesh } from '../components/FaceMesh';
+export { DEFAULT_TRACKING_ANCHOR, TrackingAnchor } from '../components/TrackingAnchor';
+export type { TrackingAnchorSettings } from '../components/TrackingAnchor';
+export { GestureTrigger } from '../components/GestureTrigger';
 export type { GestureTriggerProps } from '../components/GestureTrigger';
+export { useGesture } from '../hooks/useGesture';
+export type { UseGestureOptions } from '../hooks/useGesture';
+export { GestureListener } from '../components/GestureListener';
+export type { GestureListenerProps } from '../components/GestureListener';
+export { DEFAULT_GESTURE_DETECTOR_OPTIONS, DEFAULT_GESTURE_SETTINGS, GESTURES, GESTURE_NAMES, GESTURE_SETTINGS_FIELDS, defineGesture, patchGestureSettings, resolveGestureDefinition, resolveGestureDetectorOptions, resolveGestureSettings, } from '../gestures';
+export type { AnyGestureDefinition, BuiltInGestureName, GestureContext, GestureDefinition, GestureDetectorOptions, GestureEndReason, GestureInputOf, GestureKind, GesturePhase, GestureRef, GestureSample, GestureSettings, GestureState, } from '../gestures';
+export { BodyTrigger, useBodyTrigger } from '../components/BodyTrigger';
+export type { BodyTriggerProps, UseBodyTriggerOptions } from '../components/BodyTrigger';
+export { BODY_MOVES, BODY_MOVE_LIMITS, BODY_MOVE_NAMES, BODY_MOVE_VIEW_LIMITS, defineBodyMove, resolveBodyMove, } from '../body-trigger';
+export type { AnyBodyMoveDefinition, BodyMoveContext, BodyMoveDefinition, BodyMoveFrame, BodyMoveJointName, BodyMoveLimits, BodyMoveName, BodyMoveRef, BodyMoveSample, BodyMoveSide, BodyMoveViewLimits, BodyTriggerOptions, BodyTriggerState, BodyTriggerTarget, } from '../body-trigger';
+export { BODY_CALIBRATION_LANDMARKS, CALIBRATION_STORAGE_KEY, CALIBRATION_VERSION, DEFAULT_CALIBRATION, FACE_CALIBRATION_LANDMARKS, applyCalibrationToFeedPoint, clearCalibration, createCalibration, estimateBodyScale, estimateFaceDistance, isIdentityCalibration, loadCalibration, measureBodyCalibration, measureFaceCalibration, resetCalibration, resolveCalibrationMirror, saveCalibration, updateCalibration, useXRCalibration, } from '../calibration';
+export type { CalibrationStorage, UseXRCalibrationOptions, UseXRCalibrationResult, XRBodyCalibration, XRCalibration, XRCalibrationPatch, XRFaceCalibration, } from '../calibration';
+export { DEFAULT_SUBJECT_POLICY, EMPTY_SUBJECT_MEMORY, XR_MAX_SUBJECTS, associateSubjects, bodyCandidates, faceCandidates, jointCandidates, selectSubject, } from '../subjects';
+export type { XRSubjectAssociation, XRSubjectCandidate, XRSubjectMemory, XRSubjectPolicy, XRSubjectSelection, XRSubjectSelectionResult, } from '../subjects';
 export { useFaceResults } from '../hooks/useFaceResults';
-export type { FaceTarget, HandTarget, BodyTarget, TrackingTarget, TrackerType, } from '../types/tracking';
+export { DEFAULT_POLICY_NUM_FACES, useFaceInfo } from '../hooks/useFaceInfo';
+export type { UseFaceInfoOptions } from '../hooks/useFaceInfo';
+export { useFaceInfos } from '../hooks/useFaceInfos';
+export type { UseFaceInfosOptions } from '../hooks/useFaceInfos';
+export { useFaceDetection } from '../hooks/useFaceDetection';
+export { useIrisTracking } from '../hooks/useIrisTracking';
+export type { IrisTrackingHandle, IrisTrackingStatus, UseIrisTrackingOptions, } from '../hooks/useIrisTracking';
+export { IRIS_LANDMARKS, IRIS_LANDMARK_COUNT } from '../iris';
+export type { IrisEye, IrisPoint, IrisResult, IrisSide } from '../iris';
+export type { FaceDetectionPhase, FaceDetectionState, UseFaceDetectionOptions, } from '../hooks/useFaceDetection';
+export { DEFAULT_FACE_EXPRESSION_THRESHOLD, FACE_BLENDSHAPE_NAMES, FACE_LANDMARK_INDICES, drawFaceCrop, getFaceBlendshape, getFaceEyeDistance, hasFaceExpression, } from '../face-info';
+export type { DrawFaceCropOptions, FaceBlendshapeName, FaceInfo, FaceVector3 } from '../face-info';
+export { DEFAULT_FACE_ACTION_OPTIONS, FACE_ACTION_NAMES, getFaceActionValue, getStrongestFaceAction, hasFaceAction, } from '../face-action';
+export type { FaceActionDefaults, FaceActionName, FaceActionOptions, FaceActionPhase, FaceActionState, StrongestFaceAction, } from '../face-action';
+export { useFaceAction } from '../hooks/useFaceAction';
+export { DEFAULT_FACE_ATTRIBUTE_EXPRESSION_MODEL_URL, useFaceAttributeExpression, } from '../hooks/useFaceAttributeExpression';
+export type { FaceAttributeExpressionStatus, UseFaceAttributeExpressionOptions, UseFaceAttributeExpressionResult, } from '../hooks/useFaceAttributeExpression';
+export { FACE_ATTRIBUTE_EXPRESSION_NAMES } from '../face-attribute-expression';
+export type { FaceAttributeExpressionName, FaceAttributeExpressionResult, FaceAttributeExpressionScoreName, } from '../face-attribute-expression';
+export type { FaceTarget, FaceCustomAnchorPoint, HandTarget, BodyTarget, TrackingTarget, TrackerType, } from '../types/tracking';
 export { FACE_TARGETS, HAND_TARGETS, BODY_TARGETS, getTargetNamespace } from '../types/tracking';
+export { normalizedTrackerPointToTrackerPoint, trackerPointToNormalizedTrackerPoint, } from '../tracking/coordinates';
+export type { NormalizedTrackerPoint, TrackerPoint } from '../types/common';
 export type { SegmentationType } from '../types/segmentation';
 export { SEGMENTATION_TYPES } from '../types/segmentation';
+export { SegmentationOverlay, useHairMask, usePersonMask, useSemanticSegmentationMask, PERSON_MASK_LABELS, DEFAULT_SEGMENTATION_OVERLAY_SETTINGS, resolveSegmentationOverlaySettings, patchSegmentationOverlaySettings, } from '../components/SegmentationOverlay';
+export type { SegmentationOverlayBlendMode, SegmentationOverlayProps, SegmentationOverlaySettings, SemanticSegmentationMaskResult, UsePersonMaskOptions, UseSemanticSegmentationMaskOptions, } from '../components/SegmentationOverlay';
+export { SEMANTIC_SEGMENTATION_PRESETS } from '../types/segmentation';
+export type { SemanticSegmentationModelOptions, SemanticSegmentationPreset, SemanticSegmentationStatus, } from '../types/segmentation';
+export { createSemanticMask, clearSemanticMask } from '../segmentation2d';
+export type { SemanticMask, SemanticMaskSpace } from '../segmentation2d';

package/dist/face-action/index.d.ts

@@ -0,0 +1,34 @@
+import { FaceInfo, FaceVector3 } from '../face-info';
+export declare const FACE_ACTION_NAMES: readonly ["browRaise", "eyeBlink", "eyeBlinkLeft", "eyeBlinkRight", "eyeBlinkEither", "headUp", "headDown", "headTurnLeft", "headTurnRight", "mouthOpen", "mouthPout", "headTiltLeft", "headTiltRight"];
+export type FaceActionName = (typeof FACE_ACTION_NAMES)[number];
+export type FaceActionOptions = {
+    threshold?: number;
+    releaseThreshold?: number;
+    holdMs?: number;
+    neutralRotation?: FaceVector3;
+};
+export type FaceActionDefaults = Required<Pick<FaceActionOptions, "threshold" | "releaseThreshold" | "holdMs">>;
+export type FaceActionState = {
+    action: FaceActionName;
+    active: boolean;
+    value: number;
+    justStarted: boolean;
+    justEnded: boolean;
+    phase: FaceActionPhase;
+};
+export type FaceActionPhase = "begin" | "stay" | "end" | "none";
+export declare const DEFAULT_FACE_ACTION_OPTIONS: Readonly<Record<FaceActionName, FaceActionDefaults>>;
+export declare const resolveFaceActionOptions: (action: FaceActionName, options?: FaceActionOptions) => FaceActionDefaults;
+export declare const getFaceActionValue: (face: FaceInfo, action: FaceActionName, { neutralRotation }?: Pick<FaceActionOptions, "neutralRotation">) => number;
+export declare const hasFaceAction: (face: FaceInfo, action: FaceActionName, options?: FaceActionOptions) => boolean;
+export type StrongestFaceAction = {
+    face: FaceInfo | null;
+    value: number;
+};
+export declare const getStrongestFaceAction: (faces: readonly FaceInfo[], action: FaceActionName, options?: FaceActionOptions) => StrongestFaceAction;
+export type FaceActionStepState = FaceActionState & {
+    holdStartedAt: number | null;
+};
+export declare const createFaceActionStepState: (action: FaceActionName) => FaceActionStepState;
+/** Internal hook state step; exported from this module only for focused tests. */
+export declare const stepFaceActionState: (state: FaceActionStepState, value: number, now: number, hasFace: boolean, options: FaceActionDefaults) => FaceActionStepState;

package/dist/face-atlas/attributes.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Static per-vertex data of the face atlas, in landmark order (468 vertices)
+ * and in the canonical head frame (cm, +X toward landmark 263, +Y up, +Z out
+ * of the face). Bind them as vertex attributes of an atlas mesh.
+ */
+export type FaceAtlasAttributes = {
+    /** `[x, y, z, …]` rest position, cm (`CANONICAL_FACE_POSITIONS`). */
+    restPosition: Float32Array;
+    /** `[x, y, z, …]` unit rest normal, area-weighted over every atlas triangle. */
+    restNormal: Float32Array;
+    /** Distance to the face oval along the surface, cm: 0 on the oval, growing inward. */
+    edge: Float32Array;
+    /** Position across the lip band: 0 on the outer lip ring, 1 on the inner ring and off the lips. */
+    lipEdge: Float32Array;
+    /**
+     * Edge hops to the nearer lash ring, above and below: 0 on the lash line,
+     * 3 on the brow's lower edge and on the under-eye row (111, 117–121), 4 on
+     * the brow's upper edge.
+     */
+    eyeRing: Float32Array;
+};
+/** Every atlas triangle except the eye and mouth fills, as triangle indices. */
+export declare const faceAtlasOpenTriangles: () => number[];
+/** The lip band: triangle indices between the outer and inner lip rings (sorted). */
+export declare const getFaceAtlasLipBand: () => readonly number[];
+/**
+ * The face atlas's static vertex attributes, computed once and shared (do not
+ * mutate them; copy into your own buffer attribute if you must).
+ */
+export declare const getFaceAtlasAttributes: () => FaceAtlasAttributes;