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

package/dist/entries/all.d.ts

@@ -4,13 +4,15 @@
  * This exists only so the internal example playground can keep resolving a
  * flat `@vincentt-xr/sdk` alias without editing its demo files. It is
  * never listed in `package.json` `exports`; real apps import from the split
- * subpaths (`.`, `/tracking`, `/face-effects`, `/low-level`). `/internal` is
+ * subpaths (`.`, `/tracking`, `/instructions`, `/face-effects`, `/particles`, `/low-level`). `/internal` is
  * included here because the playground demos the debugger — which is exactly
  * why this aggregate is example-only and never shipped.
  */
 export * from './core';
 export * from './tracking';
+export * from './instructions';
 export * from './face-effects';
+export * from './particles';
 export * from './low-level';
 export * from './internal';
 export * from './scene-object';

package/dist/entries/core.d.ts

@@ -3,7 +3,7 @@
  *
  * Session root, scene, screen-space layout, and content primitives — the
  * frame every AR app has, with no tracker and no effect. Task-specific
- * surface lives behind subpaths: `/tracking`, `/face-effects`, `/low-level`.
+ * surface lives behind subpaths: `/tracking`, `/instructions`, `/face-effects`, `/low-level`.
  */
 export { XRProvider } from '../components/XRProvider';
 export { XRScene } from '../components/XRScene';
@@ -67,7 +67,8 @@ export type { CaptureStatus, FrameCaptureEvents, UseFrameCaptureOptions, } from
 export { dataURLtoFile } from '../utils/dataURL';
 export { drawNormalizedCrop, resolveNormalizedCrop } from '../utils/drawNormalizedCrop';
 export { computeFeedCrop, computeFitLayout, feedToScreenPixels, feedToSource, feedToTracker, feedToViewport, feedToWorld, isFeedPointInSource, isMirroredSourceKind, mirrorFeedX, orientSourcePoint, orientedSize, screenPixelsToFeed, sourceToFeed, trackerToFeed, trackerToWorld, viewportToFeed, worldToFeed, worldToTracker, } from '../coordinates';
-export type { FeedCrop, FeedPoint, FeedSourceKind, FitLayout, PixelSize, SourceOrientation, SourcePoint, ViewportPoint, } from '../coordinates';
+export { feedSidedName, otherSide, personLeftSign, personSide, swapSidedName, } from '../coordinates';
+export type { FeedCrop, FeedPoint, FeedSourceKind, FitLayout, PersonSide, PixelSize, SourceOrientation, SourcePoint, ViewportPoint, } from '../coordinates';
 export type { CropOutputSize, DrawNormalizedCropOptions, NormalizedCropBounds, } from '../utils/drawNormalizedCrop';
 export { AudioEngine, AudioPlayer, audio, prefetchMusic, registerSound, startMusic, stopMusic, playOneShot, setMuted, toggleMuted, isMuted, onMuteChange, useMuted, } from '../audio';
 export type { AudioEngineOptions, AudioPlayerHandle, AudioPlayerProps, AudioPlayMode, } from '../audio';

package/dist/entries/face-effects.d.ts

@@ -1,8 +1,9 @@
 /**
  * `@vincentt-xr/sdk/face-effects` — face-filter power-user surface.
  *
- * FaceMesh material configuration, landmark-driven retouch, the canonical
- * face mesh, and the head-binding solver + occluders. The bare
+ * FaceMesh material configuration, landmark-driven retouch, lip and iris
+ * effects, face insets, 2D segmentation overlays, the canonical face mesh, and the
+ * head-binding solver + occluders. The bare
  * `<FaceMesh appearance={{ map }} />` is in `/tracking`; this is its deep
  * configuration.
  */
@@ -10,18 +11,123 @@ export { IrisEffect, DEFAULT_IRIS_EFFECT_RENDER_ORDER, DEFAULT_IRIS_EFFECT_SETTI
 export type { IrisEffectEye, IrisEffectMode, IrisEffectProps, IrisEffectSettings, IrisMaterialContext, IrisMaterialOverride, IrisUniforms, } from '../components/IrisEffect';
 export { blendModeIndices, DEFAULT_APPEARANCE, DEFAULT_FACE_MESH_RENDERER, DEFAULT_FACE_MESH_TRANSFORM, DEFAULT_MASKING, FACE_MESH_ALPHA_MAPS, FACE_MESH_BLEND_MODES, FACE_MESH_MASK_TEXTURE_SOURCES, FACE_MESH_MATERIAL_TYPES, FACE_MESH_SHADER_PRESETS, FACE_MESH_SIDES, FACE_MESH_TEXTURE_MAPS, materialTypeOptions, shaderPresetOptions, sideOptions, textureMapOptions, alphaMapOptions, blendModeOptions, supportsTexturePanel, supportsBlendMode, } from '../components/FaceMesh';
 export type { FaceMeshMaterialType, FaceMeshShaderPreset, FaceMeshTextureMap, FaceMeshAlphaMap, FaceMeshMaskTextureSource, FaceMeshSide, FaceMeshBlendMode, FaceMeshAppearance, FaceMeshMasking, } from '../components/FaceMesh';
-export { LipEffect, LipEffects, LipEffectMaterial, LIP_EFFECT_VERTEX_SHADER, LIP_EFFECT_FRAGMENT_SHADER, createLipEffectMaterial, updateLipEffectMaterial, useLipEffectMaterial, useLipDesignTextures, resolveLipEffectFaceConfig, DEFAULT_LIP_EFFECT, DEFAULT_LIP_EFFECT_RENDER_ORDER, DEFAULT_LIP_EFFECT_SETTINGS, LIP_EFFECT_COLOR_MODES, LIP_EFFECT_GRADIENT_DIRECTIONS, LIP_EFFECT_PRESETS, LIP_EFFECT_PRESET_KEYS, LIP_EFFECT_SETTINGS_FIELDS, CANONICAL_LIP_UV_BOUNDS, LIP_UV_GUIDE_COLORS, createLipTextureTransform, createLipUvGuideDataUrl, createLipUvGuidePngBlob, createLipUvGuideSvg, getLipUvBounds, isLipEffectPresetKey, lipUvToPixel, patchLipEffectSettings, resolveLipEffectSettings, } from '../components/LipEffect';
+export { LipEffect, LipEffects, LipEffectMaterial, LIP_EFFECT_VERTEX_SHADER, LIP_EFFECT_FRAGMENT_SHADER, createLipEffectMaterial, lipEffectDesignDecode, updateLipEffectMaterial, useLipEffectMaterial, useLipDesignTextures, resolveLipEffectFaceConfig, DEFAULT_LIP_EFFECT, DEFAULT_LIP_EFFECT_RENDER_ORDER, DEFAULT_LIP_EFFECT_SETTINGS, LIP_EFFECT_COLOR_MODES, LIP_EFFECT_GRADIENT_DIRECTIONS, LIP_EFFECT_PRESETS, LIP_EFFECT_PRESET_KEYS, LIP_EFFECT_SETTINGS_FIELDS, CANONICAL_LIP_UV_BOUNDS, LIP_UV_GUIDE_COLORS, createLipTextureTransform, createLipUvGuideDataUrl, createLipUvGuidePngBlob, createLipUvGuideSvg, getLipUvBounds, isLipEffectPresetKey, lipUvToPixel, patchLipEffectSettings, resolveLipEffectSettings, } from '../components/LipEffect';
 export type { LipEffectFaceConfig, LipEffectsProps, LipEffectMaterialInputs, LipEffectMaterialResult, LipEffectMaterialProps, LipEffectMaterialSpec, LipEffectColorMode, LipEffectGradientDirection, LipEffectMaterialContext, LipEffectPreset, LipEffectPresetKey, LipEffectProps, LipEffectSettings, LipMaskMode, LipUvBounds, LipUvGuideOptions, } from '../components/LipEffect';
-export { CanonicalFaceMeshRenderer, FaceMeshMaterial, FaceMeshRenderer, canonicalFaceAlphaMaskUrl, canonicalFaceTextureStyle2Url, canonicalFaceTextureUrl, CANONICAL_FACE_MESH_GEOMETRY_SPECS, mapFaceMeshRendererProps, mapFaceMeshRendererSettingsToProps, resolveFaceMeshRendererSettings, useCanonicalFaceMesh, parseCanonicalFaceModel, } from '../components/FaceMesh';
-export type { CanonicalFaceMeshRendererProps, CanonicalFaceMeshGeometryKey, CanonicalFaceMeshGeometrySpec, FaceMeshMaterialOverride, FaceMeshMaterialOverrideContext, FaceMeshMaterialOverrideResult, FaceMeshMaterialProps, FaceMeshRendererProps, FaceMeshRendererSettings, ParsedCanonicalMesh, } from '../components/FaceMesh';
-export { FACE_WARP_3D_PRESET, DEFAULT_FACE_WARP_3D_SETTINGS } from '../components/FaceWarp3D';
-export type { FaceWarp3DSettings } from '../components/FaceWarp3D';
+export { FACE_ATLAS_ANCHORS, FACE_ATLAS_GUIDE_COLORS, FACE_ATLAS_MIRROR, FACE_ATLAS_POLYLINES, FACE_ATLAS_POLYLINE_NAMES, FACE_ATLAS_REGIONS, FACE_ATLAS_SOURCE, FACE_ATLAS_TRIANGLES, FACE_ATLAS_UVS, createFaceAtlasGuideDataUrl, createFaceAtlasGuidePngBlob, createFaceAtlasGuideSvg, createFaceAtlasMask, createFaceAtlasMaskTexture, createFaceAtlasPolylineGlsl, faceAtlasAnchorPosition, faceAtlasMaskToRgba, faceAtlasUvToPixel, getFaceAtlasAttributes, getFaceAtlasRegionBounds, getFaceAtlasRegionIndices, getFaceAtlasRegionTriangles, mirrorFaceAtlasPolyline, mirrorFaceAtlasUv, } from '../face-atlas';
+export type { FaceAtlasAnchorName, FaceAtlasAttributes, FaceAtlasGuideOptions, FaceAtlasMask, FaceAtlasMaskOptions, FaceAtlasMaskTextureOptions, FaceAtlasPolyline, FaceAtlasPolylineName, FaceAtlasRegion, FaceAtlasRegionSelection, FaceAtlasUvBounds, } from '../face-atlas';
+export { FACE_ATLAS_STENCIL, FACE_RETOUCH_RENDER_ORDER, FaceAtlasLayer, MAKEUP_BLENDING, MAKEUP_RENDER_ORDER, useFaceAtlasSurface, } from '../components/FaceAtlas';
+export type { FaceAtlasLayerProps, FaceAtlasMaterialContext, FaceAtlasMaterialResult, FaceAtlasMaterialSpec, FaceAtlasSurfaceHandle, UseFaceAtlasSurfaceOptions, } from '../components/FaceAtlas';
+export type { FaceAtlasSurface, FaceAtlasSurfaceInput, FaceAtlasSurfaceTracking, FaceAtlasTriangleSelection, } from '../face-atlas';
+export type { FaceAtlasUniforms } from '../face-atlas/registry';
+export { useFaceSkin } from '../components/FaceAtlas/useFaceSkin';
+export type { FaceSkinReference, FaceSkinUniforms, UseFaceSkinOptions, } from '../components/FaceAtlas/useFaceSkin';
+export { FaceSkinProbe } from '../face-atlas/probe/FaceSkinProbe';
+export type { FaceSkinProbeOptions, FaceSkinProbeRenderOptions, FaceSkinProbeResult, } from '../face-atlas/probe/FaceSkinProbe';
+export { FACE_SKIN_PROBE, FACE_SKIN_PROBE_TIERS, FACE_SKIN_QUALITIES, } from '../face-atlas/probe/constants';
+export type { FaceSkinProbeTier, FaceSkinQuality } from '../face-atlas/probe/constants';
+export { FACE_SKIN_STATS, readFaceSkinStats } from '../face-atlas/probe/stats';
+export type { FaceSkinStats } from '../face-atlas/probe/stats';
+export { FACE_SKIN_STATS_GLSL } from '../face-atlas/probe/glsl';
+export type { FaceSkinProbeFormat, FaceSkinStatsFormat } from '../face-atlas/probe/targets';
+export { DEFAULT_MAKEUP_SETTINGS, MAKEUP_AUTO_SHADE_REGIONS, MAKEUP_FINISHES, MAKEUP_FINISH_DEFAULTS, MAKEUP_LOOKS, MAKEUP_LOOK_NAMES, MAKEUP_REGIONS, MAKEUP_SETTINGS_FIELDS, MAKEUP_SHADES, MAKEUP_SHADE_NAMES, MAKEUP_SHAPES, MAKEUP_SHAPE_NAMES, MAKEUP_SIDES, isMakeupLookName, isMakeupShadeName, isMakeupShape, patchMakeupSettings, resolveMakeupLook, resolveMakeupSettings, resolveMakeupShade, supportsAutoMakeupShade, } from '../components/Makeup';
+export type { BlushSettings, BrowsSettings, ContourSettings, EyelinerSettings, EyeshadowSettings, HighlighterSettings, MakeupAutoShadeRegion, MakeupFaceRegion, MakeupFinish, MakeupFinishDefaults, MakeupLook, MakeupLookName, MakeupRegion, MakeupRegionSettings, MakeupSettings, MakeupSettingsInput, MakeupShadeName, MakeupShadeSetting, MakeupShape, MakeupSide, } from '../components/Makeup';
+export { Blush, Brows, Contour, Eyeliner, Eyeshadow, Highlighter, createMakeupMaterial, updateMakeupMaterial, } from '../components/Makeup';
+export type { BlushProps, BrowsProps, ContourProps, EyelinerProps, EyeshadowProps, HighlighterProps, MakeupMaterial, MakeupMaterialContext, MakeupMaterialInputs, MakeupMaterialRegion, MakeupMaterialSettings, MakeupMaterialSpec, MakeupRegionProps, MakeupUniforms, } from '../components/Makeup';
+export { MAKEUP_GLSL } from '../face-atlas/glsl';
+export { DEFAULT_MAKEUP_DESIGN_SETTINGS, MAKEUP_DESIGN_SETTINGS_FIELDS, MakeupDesign, patchMakeupDesignSettings, resolveMakeupDesignSettings, setMakeupDesignTexture, } from '../components/Makeup';
+export type { MakeupDesignProps, MakeupDesignSettings, MakeupDesignTexture, } from '../components/Makeup';
+export { MAKEUP_SKIN_DEPTHS, MAKEUP_SKIN_READY, MAKEUP_SKIN_TONE, MAKEUP_UNDERTONES, classifyMakeupSkinDepth, classifyMakeupUndertone, computeMakeupSkinTone, nearestMakeupShades, useMakeupSkinTone, } from '../components/Makeup';
+export type { ComputeMakeupSkinToneOptions, MakeupShadeRecommendations, MakeupSkinDepth, MakeupSkinTone, MakeupSkinToneInput, MakeupUndertone, UseMakeupSkinToneOptions, } from '../components/Makeup';
+export { MadeUpCamera, useMadeUpCamera, useMadeUpCameraTexture } from '../components/FaceAtlas';
+export type { MadeUpCameraHandle, MadeUpCameraProps, UseMadeUpCameraOptions, } from '../components/FaceAtlas';
+export { MADE_UP_CAMERA_LAYER, feedTextureVersion } from '../face-atlas/madeUpCamera';
+export { CanonicalFaceMeshRenderer, FaceMeshMaterial, FaceMeshRenderer, canonicalFaceAlphaMaskUrl, canonicalFaceTextureStyle2Url, canonicalFaceTextureUrl, CANONICAL_FACE_MESH_GEOMETRY_SPECS, resolveFaceMeshEyeVisibility, mapFaceMeshRendererProps, mapFaceMeshRendererSettingsToProps, resolveFaceMeshRendererSettings, useCanonicalFaceMesh, parseCanonicalFaceModel, } from '../components/FaceMesh';
+export type { CanonicalFaceMeshRendererProps, CanonicalFaceMeshGeometryKey, CanonicalFaceMeshGeometrySpec, FaceMeshEyeVisibility, FaceMeshMaterialOverride, FaceMeshMaterialOverrideContext, FaceMeshMaterialOverrideResult, FaceMeshMaterialProps, FaceMeshRendererProps, FaceMeshRendererSettings, ParsedCanonicalMesh, } from '../components/FaceMesh';
+export { FACE_INSET_BOXES, FACE_INSET_HOLD_MS, FACE_INSET_PARTS, FACE_INSET_PLACEMENTS, FACE_INSET_RENDER_ORDER, FaceInset, createFaceInsetFrame, faceInsetAspect, useFaceInsetTexture, writeFaceInsetFrame, } from '../components/FaceInset';
+export type { FaceInsetEllipse, FaceInsetFrame, FaceInsetFrameOptions, FaceInsetPart, FaceInsetPlacement, FaceInsetProps, FaceInsetTextureOptions, } from '../components/FaceInset';
+export { FACE_LIQUIFY_DEFAULT_SMOOTHING, FACE_LIQUIFY_FACE_HEIGHT, FACE_LIQUIFY_FADE, FACE_LIQUIFY_FAR_SIDE, FACE_LIQUIFY_FRAME_PRIORITY, FACE_LIQUIFY_KINDS, FACE_LIQUIFY_KIND_CODE, FACE_LIQUIFY_KIND_LIMITS, FACE_LIQUIFY_MAX_FACES, FACE_LIQUIFY_MAX_OPS, FACE_LIQUIFY_MAX_WEIGHT, FACE_LIQUIFY_OP_FLOATS, FACE_LIQUIFY_POINTS, FACE_LIQUIFY_PRESETS, FACE_LIQUIFY_PRESET_NAMES, FACE_LIQUIFY_RENDER_ORDER, FACE_LIQUIFY_WEIGHT_EXPONENT, FaceLiquify, applyFaceLiquifyOp, createFaceLiquifyFrame, createFaceLiquifyPresence, faceLiquifySideVisibility, faceLiquifyWarpSide, resetFaceLiquifyPresence, stepFaceLiquifyPresence, faceLiquifyAmount, faceLiquifyBounds, faceLiquifyFalloff, faceLiquifyLandmarkPoint, resolveFaceLiquifyWarps, sampleFaceLiquify, writeFaceLiquifyFrame, writeFaceLiquifyOps, } from '../components/FaceLiquify';
+export type { FaceLiquifyBounds, FaceLiquifyCustomWarps, FaceLiquifyFrame, FaceLiquifyKind, FaceLiquifyPoint2, FaceLiquifyPointName, FaceLiquifyPresence, FaceLiquifyPresetName, FaceLiquifyProps, FaceLiquifyResolution, FaceLiquifyResolvedWarp, FaceLiquifySide, FaceLiquifyWarp, FaceLiquifyWeights, } from '../components/FaceLiquify';
+export { FACELESS_FRAME_PRIORITY, FACELESS_MAX_FACES, Faceless, useFacelessTexture, } from '../components/Faceless';
+export type { FacelessProps, UseFacelessTextureOptions } from '../components/Faceless';
+export { FACELESS_DEFAULTS, FACELESS_FRAGMENT, FACELESS_REGIONS, FACELESS_STYLES, FacelessTexture, createFacelessMask, createFacelessStretchMask, } from '../face-character/faceless';
+export type { FacelessStyle, FacelessTextureOptions } from '../face-character/faceless';
+export { FaceWarp3D } from '../components/FaceWarp3D';
+export { readLiveNumber, readLiveRecord } from '../face-character/liveValue';
+export { createCanonicalFaceGeometry } from '../face-character/canonicalFaceGeometry';
+export { alignFaceFeatures, canonicalFaceFeatures, createFeatureWarp, } from '../face-character/featureWarp';
+export type { FaceFeatureAlignment } from '../face-character/featureWarp';
+export type { LiveValue } from '../face-character/liveValue';
+export type { FaceWarp3DProps } from '../components/FaceWarp3D';
+export { FACE_WARP_MAX_KEYS, bindFaceWarpDeformation, createFaceWarpGpuData, createFaceWarpMesh, stepFaceWarp3D, writeFaceWarpLiveTexels, } from '../face-character/faceWarp3D';
+export type { FaceWarpGpuData, FaceWarpDeformation, FaceWarpMesh, FaceWarpStepOptions, } from '../face-character/faceWarp3D';
 export { FACE_RETOUCH_DEFAULT_CONTROLS, FACE_RETOUCH_SETTINGS_FIELDS, FaceRetouch, patchFaceRetouchControls, resolveFaceRetouchControls, } from '../components/FaceRetouch';
 export type { FaceRetouchControls, FaceRetouchProps } from '../components/FaceRetouch';
 export { HeadBinding } from '../components/HeadBinding';
 export type { HeadBindingOccluderOptions, HeadBindingProps } from '../components/HeadBinding';
 export { HeadBindingOccluder } from '../components/HeadBindingOccluder';
-export { HEAD_OCCLUDER_DEFAULT_OPACITY, HEAD_OCCLUDER_DEFAULT_POSITION, HEAD_OCCLUDER_DEFAULT_SCALE, HeadOccluder, } from '../components/HeadOccluder';
+export { HEAD_OCCLUDER_DEFAULT_OPACITY, HEAD_OCCLUDER_DEFAULT_POSITION, HEAD_OCCLUDER_DEFAULT_SCALE, HEAD_OCCLUDER_DEFAULT_SMOOTHING, HEAD_OCCLUDER_RENDER_ORDER, HEAD_OCCLUDER_V2_PATH, HEAD_OCCLUDER_V3_PATH, HeadOccluder, headOccluderUrl, CanonicalHeadFrame, CANONICAL_HEAD_FIT_DEFAULT_SMOOTHING, useCanonicalHeadFit, HeadAttachment, HEAD_ATTACHMENT_POINTS, HEAD_ATTACHMENT_POINT_NAMES, getHeadAttachmentPoint, resolveHeadAttachmentPoint, Earrings, NECK_BUST_TORSO_POSITION, NECK_OCCLUDER_BUST_PATH, NECK_OCCLUDER_FOLLOWS, NECK_OCCLUDER_SHOULDER_TURN, NECK_OCCLUDER_TYPES, NeckOccluder, neckBoneTwist, neckOccluderUrl, } from '../components/HeadOccluder';
+export type { HeadOccluderFit, HeadOccluderOffset, HeadOccluderProps, CanonicalHeadFrameProps, CanonicalHeadFitOptions, CanonicalHeadOffset, HeadAttachmentPoint, HeadAttachmentProps, ResolvedHeadAttachmentPoint, EarringsProps, EarringSide, NeckOccluderFollow, NeckOccluderOptions, NeckOccluderProps, NeckOccluderType, } from '../components/HeadOccluder';
+export { SpringSwing } from '../components/SpringSwing';
+export type { SpringSwingProps } from '../components/SpringSwing';
+export { SPRING_DEFAULTS, SPRING_MAX_FRAME, SPRING_MAX_JUMP, SPRING_MAX_SUBSTEP, SPRING_SETTINGS_RANGES, SPRING_SWING_LENGTH, SpringChain, SpringJoint, SpringSwingDriver, insertSwingPivots, resolveSpringSettings, } from '../spring';
+export type { SpringSettings, SpringSwingOptions, SwingPivot } from '../spring';
+export { NECKLACE_SWING_DEFAULTS, NECKLACE_SWING_NODES, Necklace } from '../components/Necklace';
+export type { NecklaceProps } from '../components/Necklace';
+export { HAIR_LOCK_DEFAULTS, HAIR_LOCK_SPRING, HairLock, createLockGeometry, writeLock, } from '../components/HairLock';
+export type { HairLockProps } from '../components/HairLock';
+export { ExternalFaceMesh, FACE_HEAD_WIDTH_RATIO, faceHeadWidth, FaceExpressionController, FaceRig, FaceRigContext, useExpressionValues, PinToFaceMesh, FacePiercing, FaceSurfaceOccluder, ExternalFaceMeshContext, FaceMorph, FaceReprojection, useExternalFaceMesh, useFaceRig, } from '../components/FaceCharacter';
+export type { ExternalFaceMeshBinding, ExternalFaceMeshPart, ExternalFaceMeshProps, FaceExpressionControllerProps, FaceExpressionControllerRule, ExpressionOutputs, FaceRigProps, UseExpressionValuesResult, PinToFaceMeshProps, FacePiercingProps, FaceSurfaceOccluderProps, } from '../components/FaceCharacter';
+export { createExpressionOutputs } from '../face-character/expressionOutputs';
+export type { ExpressionOutputRule } from '../face-character/expressionOutputs';
+export { compileExpressionInput, createExpressionState, expressionFrame, resetExpressions, shapeExpressionValue, stepExpressions, } from '../face-character/faceExpressions';
+export type { ExpressionFrame, ExpressionInput, ExpressionRule, ExpressionShape, ExpressionState, ExpressionValue, } from '../face-character/faceExpressions';
+export { FACE_PIN_PATCH_RADIUS, FACE_PIN_TARGETS, bindFacePin, facePinAnchorForFeed, projectFacePinOnto, stepFacePin, } from '../face-character/facePin';
+export type { FacePinAnchor, FacePinBinding, FacePinOrient, FacePinSurface, } from '../face-character/facePin';
+export { FACE_PIERCINGS, FACE_PIERCING_KINDS, FACE_PIERCING_NAMES, mirrorFacePiercingOffset, mirrorFacePiercingPlacement, resolveFacePiercing, } from '../face-character/facePiercings';
+export type { FacePiercingKind, FacePiercingName, FacePiercingNudge, FacePiercingOffset, FacePiercingPlacement, FacePiercingPreset, ResolvedFacePiercing, } from '../face-character/facePiercings';
+export { CANONICAL_FACE_LANDMARK_COUNT, CANONICAL_FACE_POSITIONS, CANONICAL_FACE_TRIANGLES, CANONICAL_FACE_UVS, } from '../face-character/canonicalFace';
+export { FACE_RESIDUAL_LENGTH, bindFaceMesh, deformFaceMesh, sampleResidual, } from '../face-character/faceMeshBinding';
+export type { FaceMeshBinding, FaceMeshBindingMode, FaceMeshBindingOptions, } from '../face-character/faceMeshBinding';
+export { FACE_AUTO_ALIGN_MAX, FACE_HEAD_FIT_RAMP, autoFaceModelAlignment, bindFaceModel, measureFaceModelEarWidth, } from '../face-character/bindFaceModel';
+export type { BindFaceModelOptions, BoundFaceMesh, FaceModelAlignment, FaceMorphTarget, } from '../face-character/bindFaceModel';
+export { driveFaceModel, planFaceDrive } from '../face-character/driveFaceModel';
+export type { DriveFaceModelOptions, FaceDriveMode, FaceDrivePlan, } from '../face-character/driveFaceModel';
+export { FACE_GAZE_CHANNELS, FACE_MORPH_NAMES, FACE_REGION_MASKS, faceMorphChannel, faceMorphRegion, } from '../face-character/faceMorphs';
+export type { FaceMorphName, FaceMorphRegion } from '../face-character/faceMorphs';
+export { FACE_MORPH_COUNT, FACE_RIG_FAST_MOVE_CM, FACE_RIG_FAST_TURN_DEG, createFaceRigState, recalibrateFaceRig, stepFaceRig, } from '../face-character/faceRig';
+export type { FaceRigOptions, FaceRigState, FaceRigTracking } from '../face-character/faceRig';
+export type { FaceMorphProps, FaceReprojectionProps } from '../components/FaceCharacter';
+export { FACE_SURFACE_RENDER_ORDER, faceSurfaceBlending, markFaceSurface, useFaceSurface, } from '../components/FaceCharacter';
+export type { FaceSurfaceState } from '../components/FaceCharacter';
+export { createFaceMorphLive, createFaceMorphShape, stepFaceMorph, subdivideFaceUnwrap, writeFaceMorphLive, } from '../face-character/faceMorph';
+export type { SubdividedFace, FaceMorphShape, FaceMorphShapeName, FaceMorphStepOptions, } from '../face-character/faceMorph';
+export { FACE_REPROJECTION_FILL_REACH, bindFaceReprojection, createClosestPointSearch, createFaceReprojectionUniforms, faceReprojectionRegionEllipses, faceUnwrapTexelsPerCm, faceReprojectionRegionMask, getFaceUnwrapMesh, getFaceUnwrapUvs, patchFaceReprojectionMaterial, writeFaceFacing, writeFaceReprojectionLayoutUv, writeFaceUnwrapFrame, } from '../face-character/faceReprojection';
+export type { ClosestPoint, FaceImageLandmark, FaceOpening, FaceReprojectionBinding, FaceReprojectionBindingOptions, FaceReprojectionRegion, FaceReprojectionShading, FaceReprojectionUniforms, FaceUnwrapFrameOptions, FaceUnwrapMesh, } from '../face-character/faceReprojection';
+export { FaceReprojector } from '../face-character/faceReprojector';
+export type { FaceReprojectionTarget, FaceReprojectorOptions, } from '../face-character/faceReprojector';
+export { DEFAULT_FACE_MIRROR_SETTINGS, DEFAULT_FACE_SWAP_SETTINGS, FACE_MIRROR_SETTINGS_FIELDS, FACE_MIRROR_VARIANTS, FACE_MIRROR_VARIANT_LABELS, FACE_SWAP_EACH_OTHER, FACE_SWAP_PAINTED_FEATURE_SOFTNESS, FACE_SWAP_PRESETS, FACE_SWAP_PRESET_KEYS, FACE_SWAP_SETTINGS_FIELDS, FACE_SWAP_SETTINGS_RANGES, FACE_SWAP_SOURCE_KINDS, FaceMirror, FaceSwap, FaceTextureLayer, defaultFaceSwapPreset, faceMirrorTransferSettings, isFaceMirrorVariant, isFaceSwapPresetKey, patchFaceMirrorSettings, patchFaceSwapSettings, resolveFaceMirrorSettings, resolveFaceSwapSettings, useFaceTexture, useLiveFaceTexture, } from '../components/FaceSwap';
+export type { FaceMirrorProps, FaceMirrorSettings, FaceMirrorVariant, FaceSwapPreset, FaceSwapPresetKey, FaceSwapProps, FaceSwapSettings, FaceSwapSource, FaceSwapSourceKind, FaceSwapSourceLike, FaceSwapSourceStatus, FaceSwapStatus, FaceTextureLayerProps, FaceTextureStatus, ResolveFaceSwapSettingsOptions, UseFaceTextureOptions, UseFaceTextureResult, UseLiveFaceTextureOptions, } from '../components/FaceSwap';
+export { FACE_UNWRAP_MIRROR, mirrorFaceLandmarks, resolveFaceSourceMirror, } from '../face-character/faceTexture';
+export type { FaceTexture, FaceTextureKind, FaceTextureSource, FaceTextureStatistics, } from '../face-character/faceTexture';
+export { FACE_TEXTURE_LAYOUTS, FACE_TRANSFER_FRAGMENT_SHADER, FACE_TRANSFER_VERTEX_SHADER, FaceTransfer, faceTransferGain, } from '../face-character/faceTransfer';
+export type { FaceStatsSample, FaceTextureLayout, FaceTransferGainSettings, FaceTransferGainStats, FaceTransferOptions, FaceTransferSettings, FaceTransferUnseen, } from '../face-character/faceTransfer';
+export { FACE_SWAP_QUALITIES } from '../face-character/liveFaceRegistry';
+export type { FaceSwapQuality } from '../face-character/liveFaceRegistry';
+export { FACE_TEXTURE_RESOLUTIONS, createFaceTexture } from '../face-character/faceTextureBaker';
+export type { BakedFaceTexture, CreateFaceTextureOptions, FaceTextureResolution, } from '../face-character/faceTextureBaker';
+export { detectFaceImage, disposeFaceImageLandmarker } from '../face-character/faceImageLandmarker';
+export type { FaceImageSource } from '../face-character/faceImageLandmarker';
+export { FACE_PHOTO_WARNINGS } from '../face-character/facePhoto';
+export type { FaceImageBox, FaceImageDetection, FacePhotoPick, FacePhotoWarning, FaceTextureError, FaceTextureErrorCode, } from '../face-character/facePhoto';
+export { FACE_TEXTURE_GUIDE_COLORS, createFaceTextureGuideDataUrl, createFaceTextureGuidePngBlob, createFaceTextureGuideSvg, createFaceTextureSideTestSvg, } from '../face-character/faceTextureGuide';
+export type { FaceTextureGuideOptions, FaceTextureSideTestOptions, } from '../face-character/faceTextureGuide';
+export { LANDMARK_POSE_FIT_DEFAULT_SMOOTHING, LANDMARK_POSE_FIT_SNAP_CM, stepLandmarkPoseSmoothing, useLandmarkPoseFit, } from '../components/HeadOccluder/useLandmarkPoseFit';
+export type { CanonicalOffset, LandmarkPoseFit, LandmarkPoseFitOptions, LandmarkPoseSmoothingState, } from '../components/HeadOccluder/useLandmarkPoseFit';
+export { CANONICAL_HEAD_ANCHOR, CANONICAL_RIGID_INDICES, CANONICAL_RIGID_POINTS, solveCanonicalHeadPose, } from '../utils/headOccluderFit';
+export type { HeadPoseFit } from '../utils/headOccluderFit';
+export { CANONICAL_RIGID_LANDMARKS } from '../utils/canonicalRigidLandmarks';
+export { solveSimilarity } from '../utils/similarityFit';
+export type { SimilarityFit } from '../utils/similarityFit';
 export { computeAdaptiveVerticalFit, computeHeadBindingCubePose, computeHeadBindingDebugMetrics, computeHeadBindingShape, computeUniversalHeadDepthOffset, computeUniversalOccluderScale, computeUniversalPitchOffsetY, computeUniversalYawOffsetX, solveHeadBinding, } from '../utils/headBinding';
 export type { HeadBindingAdaptiveValues, HeadBindingCubeModel, HeadBindingCubePose, HeadBindingDebugMetrics, HeadBindingSolveResult, HeadBindingShape, } from '../types/headBinding';
 export type { FaceLandmark2D, BoundingBox, FaceRawTrackingData, FaceBounds, FaceTrackingResult, } from '../types/face';

package/dist/entries/instructions.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `@vincentt-xr/sdk/instructions` — prompts that ask the person for a hand
+ * gesture, a face expression or a body pose, show a 3D hint, and complete when
+ * it is held.
+ *
+ * Four layers, each usable on its own:
+ * - **Presets** — `HandInstruction`, `FaceInstruction`, `BodyInstruction`.
+ * - **Layout** — `Instruction` (any detector + any symbol), its text / motion /
+ *   layout options.
+ * - **Detection** — `useHandGesture`, `useFaceExpression`, `useBodyPose`,
+ *   `useInstructionHold` (any condition); the vocabularies, `define*` helpers,
+ *   pure classifiers and their thresholds.
+ * - **Hints** — `HandGestureHint`, `FaceExpressionHint`, `BodyPoseHint`, and
+ *   the kit to build your own: `useGhostModel`, `HintStage`, `sampleHintLoop`,
+ *   `createClipBlend`, `createMorphBlend`, the ghost materials.
+ */
+export { Instruction } from '../components/Instruction';
+export type { InstructionProps } from '../components/Instruction';
+export { INSTRUCTION_RENDER_ORDER, INSTRUCTION_TEXT_STYLE, } from '../components/Instruction/InstructionCue';
+export type { InstructionLayout, InstructionMotion, InstructionOptions, InstructionPlacement, InstructionSize, InstructionStatus, InstructionTextSlot, InstructionTextStyle, } from '../components/Instruction/InstructionCue';
+export { useInstructionHold } from '../components/Instruction/useInstructionHold';
+export type { InstructionDetector, InstructionHoldOptions, UseInstructionHoldOptions, } from '../components/Instruction/useInstructionHold';
+export { GESTURE_HOLD_DEFAULT_MS, GESTURE_HOLD_GRACE_MS, createGestureHoldState, stepGestureHold, } from '../components/Instruction/gestureHold';
+export type { GestureHoldState, GestureHoldStatus } from '../components/Instruction/gestureHold';
+export { HAND_HINT_LOOK, HAND_HINT_LOOP, HAND_INSTRUCTION_NUDGE_TEXT, HAND_INSTRUCTION_RENDER_ORDER, HandGestureHint, HandInstruction, useHandGesture, } from '../components/HandInstruction';
+export type { HandGestureHintProps, HandHintLoop, HandInstructionProps, HandInstructionSize, HandInstructionStatus, UseHandGestureOptions, UseHandGestureResult, } from '../components/HandInstruction';
+export { HAND_DIGITS, HAND_GESTURES, HAND_GESTURE_NAMES, HAND_SHAPE_LIMITS, analyzeHandShape, applyHandHintPose, defineHandGesture, matchHandGesture, matchingHandGestures, readHandClipPose, resolveHandGesture, } from '../hand/handGestures';
+export type { AnalyzeHandShapeOptions, HandClipPose, HandDigit, HandGestureDefinition, HandGestureMatch, HandGestureName, HandGestureRule, HandGestureSpec, HandHintAmount, HandHintPose, HandShape, HandShapeLimits, } from '../hand/handGestures';
+export { FACE_HINT_LOOK, FACE_HINT_LOOP, FACE_INSTRUCTION_NUDGE_TEXT, FACE_INSTRUCTION_RENDER_ORDER, FaceExpressionHint, FaceInstruction, useFaceExpression, } from '../components/FaceInstruction';
+export type { FaceExpressionHintProps, FaceInstructionProps, UseFaceExpressionOptions, UseFaceExpressionResult, } from '../components/FaceInstruction';
+export { FACE_EXPRESSIONS, FACE_EXPRESSION_NAMES, defineFaceExpression, matchFaceExpression, matchingFaceExpressions, resolveFaceExpression, } from '../face-expression';
+export type { FaceBlendshapes, FaceExpressionDefinition, FaceExpressionHintPose, FaceExpressionMatch, FaceExpressionName, FaceExpressionRule, FaceExpressionSpec, } from '../face-expression';
+export { BODY_HINT_LOOK, BODY_HINT_LOOP, BODY_INSTRUCTION_FULL_NUDGE_TEXT, BODY_INSTRUCTION_NUDGE_TEXT, BODY_INSTRUCTION_RENDER_ORDER, BODY_SYMBOL_ASPECT, BodyInstruction, BodyPoseHint, mixamoBoneSide, mixamoLegBoneSide, useBodyPose, } from '../components/BodyInstruction';
+export type { BodyInstructionProps, BodyPoseHintProps, UseBodyPoseOptions, UseBodyPoseResult, } from '../components/BodyInstruction';
+export { BODY_LANDMARK_COUNT, BODY_LOWER_JOINTS, BODY_POSES, BODY_POSE_JOINTS, BODY_POSE_NAMES, BODY_SHAPE_LIMITS, BODY_UPPER_JOINTS, analyzeBodyShape, defineBodyPose, matchBodyPose, matchingBodyPoses, resolveBodyPose, squareLandmarks, } from '../body-pose';
+export type { AnalyzeBodyShapeOptions, ArmShape, ArmState, BodyPoseDefinition, BodyPoseHintPose, BodyPoseMatch, BodyPoseName, BodyPoseRule, BodyPoseSpec, BodyShape, BodyShapeLimits, BodySide, LegShape, LegState, } from '../body-pose';
+export { useGhostModel } from '../components/Instruction/useGhostModel';
+export type { GhostModel, UseGhostModelOptions } from '../components/Instruction/useGhostModel';
+export { HintStage } from '../components/Instruction/HintStage';
+export type { HintStageProps } from '../components/Instruction/HintStage';
+export { HINT_LOOP_HOLD, sampleHintLoop, sampleHintOrbit, } from '../components/Instruction/hintLoop';
+export type { HintLoop, HintLoopSample } from '../components/Instruction/hintLoop';
+export { createClipBlend, createMorphBlend } from '../components/Instruction/hintBlend';
+export type { HintBlend } from '../components/Instruction/hintBlend';
+export { mergeHintLook } from '../components/Instruction/hintLook';
+export type { HintGlow, HintHalo, HintHighlight, HintLook, ResolvedHintLook, } from '../components/Instruction/hintLook';
+export { GHOST_MAX_BONES, addHintTwins, assignHintMaterials, createDepthPrepassMaterial, createGhostMaterial, createGlowMaterial, createHaloMaterial, createHintMatcap, disposeGlowMaterial, ease, hasVertexColors, orbitSpan, readClipQuaternions, } from '../components/Instruction/ghost';
+export type { GhostOptions, GhostUniforms, HaloOptions, HintMeshSet, } from '../components/Instruction/ghost';

package/dist/entries/internal.d.ts

@@ -6,7 +6,7 @@
  * the editor; app code should not import from here.
  */
 export { XRDebugView } from '../components/XRDebugView';
-export { DebuggerProvider } from '../components/Debugger/DebuggerProvider';
+export { DebuggerPanel, DebuggerProvider } from '../components/Debugger/DebuggerProvider';
 export { DebuggerOverlay } from '../components/Debugger';
 export { useDebugger } from '../hooks/useDebugger';
 export type { DebuggerMetrics, DebuggerConfig } from '../types/debugger';
@@ -14,3 +14,4 @@ export { logUVBoundsWarningOnce, _resetUVBoundsWarnings } from '../texture/hasFu
 export { readCalibrationDebugEvents, recordCalibrationDebugEvent } from '../utils/calibrationDebug';
 export { RENDER_LAYERS } from '../constants/renderLayers';
 export type { RenderLayer } from '../constants/renderLayers';
+export { FACE_SURFACE_FRAME_PRIORITY, FaceSurfaceContext, createFaceSurfaceState, } from '../components/FaceCharacter/FaceSurface';

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

@@ -12,7 +12,7 @@ export type { TrackerContextValue, TrackerLandmarkResolver } from '../hooks/useT
 export { useXRModel } from '../hooks/useXRModel';
 export type { UseXRModelResult } from '../hooks/useXRModel';
 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, useXRModelNode, useXRPipelineSnapshot, } from '../hooks/selectors';
+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';
@@ -30,6 +30,8 @@ export { EMPTY_QUALITY_SIGNALS, createQualityState, judgeSample, lockQuality, re
 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';
@@ -69,3 +71,28 @@ export { MAX_OVERLAY_LABELS, SEGMENTATION_OVERLAY_FRAGMENT_SHADER, SEGMENTATION_
 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 { createHandOccluderMaterial, patchHandOccluderInflate, } from '../components/HandRig/HandOccluder';
+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 { wristFrameLocal } from '../hand/wrist';
+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 type { AssignHandPosesOptions, HandDetection } from '../hand/handPose';

package/dist/entries/particles.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@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 { 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/tracking.d.ts

@@ -9,7 +9,38 @@
 export { FaceTracker } from '../components/FaceTracker';
 export { HandTracker } from '../components/HandTracker';
 export { GestureTracker } from '../components/GestureTracker';
-export { BodyTracker } from '../components/BodyTracker';
+export { BODY_LANDMARK_INDEX, BodyTracker, bodyLandmarkIndex } from '../components/BodyTracker';
+export { HandRig } from '../components/HandRig';
+export type { HandRigProps } from '../components/HandRig';
+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 { 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 { 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';
@@ -24,7 +55,11 @@ 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, GestureDefinition, GestureDetectorOptions, GestureEndReason, GestureInputOf, GestureKind, GesturePhase, GestureRef, GestureSample, GestureSettings, GestureState, } 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, faceCandidates, jointCandidates, selectSubject, } from '../subjects';

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;