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

package/dist/drawNormalizedCrop-B-7zU-Xw.cjs

@@ -0,0 +1 @@
+"use strict";const a=t=>typeof t=="number"&&Number.isFinite(t)&&t>0?t:0,X=t=>{const i=t;return{width:a(i.videoWidth)||a(i.naturalWidth)||a(i.width),height:a(i.videoHeight)||a(i.naturalHeight)||a(i.height)}},f=(t,i)=>Math.min(1-i,Math.max(0,t)),x=(t,i,h,d=0)=>{if(!Number.isFinite(t.minX)||!Number.isFinite(t.minY)||!Number.isFinite(t.maxX)||!Number.isFinite(t.maxY)||!a(i.width)||!a(i.height)||!a(h.width)||!a(h.height))return null;const g=t.maxX-t.minX,n=t.maxY-t.minY;if(g<=0||n<=0)return null;const r=Number.isFinite(d)?Math.max(0,d):0,c=(t.minX+t.maxX)/2,o=(t.minY+t.maxY)/2;let e=Math.min(1,g*(1+r*2)),m=Math.min(1,n*(1+r*2));const s=h.width/h.height/(i.width/i.height);e/m<s?e=Math.min(1,m*s):m=Math.min(1,e/s),e/m<s?m=e/s:e/m>s&&(e=m*s);const w=f(c-e/2,e),l=f(o-m/2,m);return{minX:w,minY:l,maxX:w+e,maxY:l+m}},Y=({source:t,bounds:i,canvas:h,outputSize:d,padding:g})=>{const n=X(t),r=x(i,n,d,g),c=Math.round(d.width),o=Math.round(d.height);if(!r||!n.width||!n.height||c<=0||o<=0)return!1;h.width!==c&&(h.width=c),h.height!==o&&(h.height=o);const e=h.getContext("2d");return e?(e.setTransform(1,0,0,1,0,0),e.clearRect(0,0,c,o),e.drawImage(t,r.minX*n.width,r.minY*n.height,(r.maxX-r.minX)*n.width,(r.maxY-r.minY)*n.height,0,0,c,o),!0):!1};exports.drawNormalizedCrop=Y;exports.resolveNormalizedCrop=x;

package/dist/drawNormalizedCrop-CRdIDyl1.js

@@ -0,0 +1,44 @@
+const a = (t) => typeof t == "number" && Number.isFinite(t) && t > 0 ? t : 0, x = (t) => {
+  const i = t;
+  return {
+    width: a(i.videoWidth) || a(i.naturalWidth) || a(i.width),
+    height: a(i.videoHeight) || a(i.naturalHeight) || a(i.height)
+  };
+}, l = (t, i) => Math.min(1 - i, Math.max(0, t)), X = (t, i, h, d = 0) => {
+  if (!Number.isFinite(t.minX) || !Number.isFinite(t.minY) || !Number.isFinite(t.maxX) || !Number.isFinite(t.maxY) || !a(i.width) || !a(i.height) || !a(h.width) || !a(h.height))
+    return null;
+  const o = t.maxX - t.minX, n = t.maxY - t.minY;
+  if (o <= 0 || n <= 0) return null;
+  const r = Number.isFinite(d) ? Math.max(0, d) : 0, c = (t.minX + t.maxX) / 2, g = (t.minY + t.maxY) / 2;
+  let e = Math.min(1, o * (1 + r * 2)), m = Math.min(1, n * (1 + r * 2));
+  const s = h.width / h.height / (i.width / i.height);
+  e / m < s ? e = Math.min(1, m * s) : m = Math.min(1, e / s), e / m < s ? m = e / s : e / m > s && (e = m * s);
+  const w = l(c - e / 2, e), f = l(g - m / 2, m);
+  return { minX: w, minY: f, maxX: w + e, maxY: f + m };
+}, Y = ({
+  source: t,
+  bounds: i,
+  canvas: h,
+  outputSize: d,
+  padding: o
+}) => {
+  const n = x(t), r = X(i, n, d, o), c = Math.round(d.width), g = Math.round(d.height);
+  if (!r || !n.width || !n.height || c <= 0 || g <= 0) return !1;
+  h.width !== c && (h.width = c), h.height !== g && (h.height = g);
+  const e = h.getContext("2d");
+  return e ? (e.setTransform(1, 0, 0, 1, 0, 0), e.clearRect(0, 0, c, g), e.drawImage(
+    t,
+    r.minX * n.width,
+    r.minY * n.height,
+    (r.maxX - r.minX) * n.width,
+    (r.maxY - r.minY) * n.height,
+    0,
+    0,
+    c,
+    g
+  ), !0) : !1;
+};
+export {
+  Y as d,
+  X as r
+};

package/dist/entries/all.d.ts

@@ -13,3 +13,4 @@ export * from './tracking';
 export * from './face-effects';
 export * from './low-level';
 export * from './internal';
+export * from './scene-object';

package/dist/entries/core.d.ts

@@ -5,17 +5,68 @@
  * frame every AR app has, with no tracker and no effect. Task-specific
  * surface lives behind subpaths: `/tracking`, `/face-effects`, `/low-level`.
  */
-export { XRProvider, XRScene, ScreenSpaceUI, ScreenTransform, useScreenRectAspect, TextLabel, Panel, VideoBackground, AspectRatioContainer, SpriteAnimation, } from '../components';
+export { XRProvider } from '../components/XRProvider';
+export { XRScene } from '../components/XRScene';
+export { ScreenSpaceUI, ScreenTransform, useScreenRectAspect } from '../components/ScreenSpaceUI';
+export { TextLabel } from '../components/TextLabel';
+export { Panel } from '../components/Panel';
+export { PinToMesh } from '../components/PinToMesh';
+export { VideoBackground } from '../components/VideoBackground';
+export { AspectRatioContainer } from '../components/AspectRatioContainer';
+export { Axes } from '../components/Axes';
+export { SpriteAnimation } from '../components/SpriteAnimation';
+export { ScreenImage } from '../components/ScreenImage';
+export { DEFAULT_SCREEN_GRADIENT, normalizeScreenGradient, ScreenGradientMaterial, } from '../components/ScreenGradient';
+export type { ScreenGradientMaterialProps, ScreenGradientSettings, } from '../components/ScreenGradient';
+export { DEFAULT_SCREEN_GLASS, normalizeScreenGlass, ScreenGlassMaterial, } from '../components/ScreenGlass';
+export type { ScreenGlassMaterialProps, ScreenGlassSettings } from '../components/ScreenGlass';
+export { ScreenShape, DEFAULT_SCREEN_SHAPE_SETTINGS, mergeScreenShapeSettings, } from '../components/ScreenShape';
+export { ScreenText } from '../components/ScreenText';
+export { MeshRenderer } from '../components/MeshRenderer';
+export { LightObject } from '../components/LightObject';
+export { LookAt } from '../components/LookAt';
+export { SceneObjectRenderer } from '../components/SceneObjectRenderer';
+export { SequentialRenderPasses } from '../components/SequentialRenderPasses';
+export { RenderGroupLayer } from '../components/RenderGroupLayer';
+export { Transform3D } from '../components/Transform3D';
+export { DEFAULT_MATERIAL_FILL, MaterialFill, MeshMaterial, createTwoStopGradient, } from '../material';
+export type { MaterialFillSettings, MaterialFillSource, MeshMaterialProps, MeshMaterialSettings, } from '../material';
 export type { PanelProps } from '../components/Panel';
+export type { AxesProps } from '../components/Axes';
 export type { TextLabelProps } from '../components/TextLabel';
 export type { ScreenTransformProps } from '../components/ScreenSpaceUI';
 export type { SpriteSheet, SpriteAnimationProps } from '../components/SpriteAnimation';
+export type { Transform3DProps, Transform3DSettings } from '../components/Transform3D';
+export { DEFAULT_TRANSFORM_3D } from '../components/Transform3D';
+export type { MeshRendererBlendMode, MeshRendererCullMode, MeshRendererDepthFunction, MeshRendererMaterialType, MeshRendererMesh, MeshRendererProps, MeshRendererRenderState, MeshRendererSettings, MeshRendererShadowMode, } from '../components/MeshRenderer';
+export { DEFAULT_MESH_RENDERER, DEFAULT_MESH_RENDERER_RENDER_STATE, normalizeMeshRendererRenderState, } from '../components/MeshRenderer';
+export type { SceneObjectRendererProps } from '../components/SceneObjectRenderer';
+export type { RenderGroupLayerProps } from '../components/RenderGroupLayer';
+export type { SequentialRenderPassesProps } from '../components/SequentialRenderPasses';
+export { EXTERNAL_BACKGROUND_RENDER_LAYER, getRenderGroupLayer, MAX_RENDER_GROUP_PASSES, renderSequentialPasses, } from '../render/renderPasses';
+export type { SequentialRenderOptions } from '../render/renderPasses';
+export type { ScreenImageProps, ScreenImageSource, ScreenImageFit, ScreenImageStretchMode, ScreenImageMaterialType, ScreenImageBlendMode, } from '../components/ScreenImage';
+export type { ScreenTextProps, ScreenTextVerticalAlign } from '../components/ScreenText';
+export type { ScreenShapeKind, ScreenShapeProps, ScreenShapeSettings, ScreenShapeSettingsInput, } from '../components/ScreenShape';
+export { DEFAULT_SCREEN_IMAGE_SETTINGS, DEFAULT_SCREEN_IMAGE_SCENE_SETTINGS, mapScreenImageSettingsToProps, } from '../screen-image/screenImageSettings';
+export type { ScreenImageSettings, ScreenImageSceneSettings, ScreenImageRenderMapping, } from '../screen-image/screenImageSettings';
+export { DEFAULT_SCREEN_TEXT_SCENE_SETTINGS, DEFAULT_SCREEN_TEXT_SHADOW_LAYER, mapScreenTextInnerShadowToProps, mapScreenTextSettingsToProps, } from '../screen-text/screenTextSettings';
+export type { ScreenTextRenderMapping, ScreenTextArtPreset, ScreenTextSettings, ScreenTextSceneSettings, ScreenTextStyle, } from '../screen-text/screenTextSettings';
+export { DEFAULT_PIXEL_SNAP_INCREMENT, DEFAULT_REFERENCE_PIXELS_PER_UNIT, DEFAULT_SCREEN_TRANSFORM_2D, DEFAULT_SCREEN_TRANSFORM_ROOT, mergeScreenTransform2D, clientToScreenPixels, mediaToScreenPixels, normalizedToScreenPixels, resolveScreenTransform2D, screenPixelsToUnits, screenPixelsToClient, screenPixelsToMedia, screenPixelsToNormalized, screenPointToRay, screenUnitsToPixels, smoothNumber, smoothVector2, smoothVector3, worldToScreenPixels, } from '../screen2d';
+export type { ProjectedScreenPixelPoint, ResolvedScreenTransform2D, ScreenClientRect, ScreenPixelPoint, ScreenTransform2DSettings, ScreenTransformRoot, ScreenUnitConversionOptions, ScreenViewportSize, } from '../screen2d';
 export { computeContainScale } from '../texture/computeContainScale';
 export { useMediaRecorder } from '../hooks/useMediaRecorder';
-export type { UseMediaRecorderOptions } from '../hooks/useMediaRecorder';
+export type { RecordingStatus, UseMediaRecorderOptions } from '../hooks/useMediaRecorder';
+export { useFrameCapture } from '../hooks/useFrameCapture';
+export type { CaptureStatus, FrameCaptureEvents, UseFrameCaptureOptions, } from '../hooks/useFrameCapture';
 export { dataURLtoFile } from '../utils/dataURL';
-export { AudioEngine, audio, prefetchMusic, registerSound, startMusic, stopMusic, playOneShot, setMuted, toggleMuted, isMuted, onMuteChange, useMuted, } from '../audio';
-export type { AudioEngineOptions } from '../audio';
+export { drawNormalizedCrop, resolveNormalizedCrop } from '../utils/drawNormalizedCrop';
+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';
+export type { PinToMeshOrientation, PinToMeshSettings, PinToMeshVector3, } from '../components/PinToMesh';
+export type { LightObjectProps, LightSettings, LightType } from '../components/LightObject';
+export type { LookAtProps, LookAtSettings } from '../components/LookAt';
 export { XRMediaSource, XRModel } from '../constants';
 export type { XRSession } from '../types';
 export type { XRPerfConfig } from '../types/model';

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

@@ -6,14 +6,18 @@
  * `<FaceMesh appearance={{ map }} />` is in `/tracking`; this is its deep
  * configuration.
  */
-export { blendModeIndices, DEFAULT_APPEARANCE, DEFAULT_MASKING, materialTypeOptions, shaderPresetOptions, sideOptions, textureMapOptions, alphaMapOptions, blendModeOptions, supportsTexturePanel, supportsBlendMode, } from '../components/FaceMesh';
+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 { CanonicalFaceMeshRenderer, useCanonicalFaceMesh, parseCanonicalFaceModel, } from '../components';
-export type { CanonicalFaceMeshRendererProps, ParsedCanonicalMesh } from '../components/FaceMesh';
-export { FaceRetouchBackground, drawFaceRetouchMask, drawMouthRetouchMask, FACE_MASK_SIZE, FACE_OVAL, LEFT_EYE, RIGHT_EYE, OUTER_LIPS, INNER_MOUTH, LEFT_EYEBROW, RIGHT_EYEBROW, createFaceRetouchRegions, DEFAULT_FEATURE_GROUPS, DEFAULT_FEATURE_POINT_INDICES, useFaceRetouchMask, useFaceRetouchRegions, } from '../components/FaceRetouch';
-export type { FaceRetouchBackgroundProps, CreateFaceRetouchRegionsOptions, } from '../components/FaceRetouch';
-export { HeadBinding, HeadBindingOccluder, HeadOccluder, HEAD_OCCLUDER_DEFAULT_OPACITY, HEAD_OCCLUDER_DEFAULT_POSITION, HEAD_OCCLUDER_DEFAULT_SCALE, } from '../components';
-export type { HeadBindingOccluderOptions, HeadBindingProps } from '../components';
+export { CanonicalFaceMeshRenderer, FaceMeshMaterial, FaceMeshRenderer, canonicalFaceAlphaMaskUrl, canonicalFaceTextureStyle2Url, canonicalFaceTextureUrl, CANONICAL_FACE_MESH_GEOMETRY_SPECS, mapFaceMeshRendererSettingsToProps, resolveFaceMeshRendererSettings, useCanonicalFaceMesh, parseCanonicalFaceModel, } from '../components/FaceMesh';
+export type { CanonicalFaceMeshRendererProps, CanonicalFaceMeshGeometryKey, CanonicalFaceMeshGeometrySpec, FaceMeshMaterialProps, 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_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 { 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, FaceRetouchRegion, FaceBounds, FaceTrackingResult, } from '../types/face';
+export type { FaceLandmark2D, BoundingBox, FaceRawTrackingData, FaceBounds, FaceTrackingResult, } from '../types/face';

package/dist/entries/internal.d.ts

@@ -5,7 +5,7 @@
  * low-level compositor/render types. Present for the SDK's own tooling and
  * the editor; app code should not import from here.
  */
-export { XRDebugView } from '../components';
+export { XRDebugView } from '../components/XRDebugView';
 export { DebuggerProvider } from '../components/Debugger/DebuggerProvider';
 export { DebuggerOverlay } from '../components/Debugger';
 export { useDebugger } from '../hooks/useDebugger';

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

@@ -6,7 +6,7 @@
  * 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';
@@ -16,15 +16,32 @@ export { useXRReady, useXRError, useXRCameraTexture, useXRRenderSize, useXRModel
 export type { GestureName } from '../hooks/useGestureEdge';
 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 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';

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,33 @@
  * 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 { BodyTracker } from '../components/BodyTracker';
+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 { useFaceResults } from '../hooks/useFaceResults';
-export type { FaceTarget, HandTarget, BodyTarget, TrackingTarget, TrackerType, } from '../types/tracking';
+export { 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 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 type { SegmentationType } from '../types/segmentation';
 export { SEGMENTATION_TYPES } from '../types/segmentation';

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-attribute-expression/index.d.ts

@@ -0,0 +1,10 @@
+export declare const FACE_ATTRIBUTE_EXPRESSION_NAMES: readonly ["angry", "disgust", "fear", "happy", "neutral", "sad", "surprise", "unknown"];
+export type FaceAttributeExpressionName = (typeof FACE_ATTRIBUTE_EXPRESSION_NAMES)[number];
+export type FaceAttributeExpressionScoreName = Exclude<FaceAttributeExpressionName, "unknown">;
+export type FaceAttributeExpressionResult = {
+    expression: FaceAttributeExpressionName;
+    confidence: number;
+    scores: Readonly<Record<FaceAttributeExpressionScoreName, number>>;
+};
+export declare const readFaceAttributeExpression: (logits: ArrayLike<number>, minConfidence?: number) => FaceAttributeExpressionResult;
+export declare const faceCropToExpressionInput: (pixels: ImageData) => Float32Array;