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

package/dist/face-info/blendshapes.d.ts

@@ -0,0 +1,3 @@
+/** MediaPipe Face Landmarker blendshape category names. */
+export declare const FACE_BLENDSHAPE_NAMES: readonly ["_neutral", "browDownLeft", "browDownRight", "browInnerUp", "browOuterUpLeft", "browOuterUpRight", "cheekPuff", "cheekSquintLeft", "cheekSquintRight", "eyeBlinkLeft", "eyeBlinkRight", "eyeLookDownLeft", "eyeLookDownRight", "eyeLookInLeft", "eyeLookInRight", "eyeLookOutLeft", "eyeLookOutRight", "eyeLookUpLeft", "eyeLookUpRight", "eyeSquintLeft", "eyeSquintRight", "eyeWideLeft", "eyeWideRight", "jawForward", "jawLeft", "jawOpen", "jawRight", "mouthClose", "mouthDimpleLeft", "mouthDimpleRight", "mouthFrownLeft", "mouthFrownRight", "mouthFunnel", "mouthLeft", "mouthLowerDownLeft", "mouthLowerDownRight", "mouthPressLeft", "mouthPressRight", "mouthPucker", "mouthRight", "mouthRollLower", "mouthRollUpper", "mouthShrugLower", "mouthShrugUpper", "mouthSmileLeft", "mouthSmileRight", "mouthStretchLeft", "mouthStretchRight", "mouthUpperUpLeft", "mouthUpperUpRight", "noseSneerLeft", "noseSneerRight"];
+export type FaceBlendshapeName = (typeof FACE_BLENDSHAPE_NAMES)[number];

package/dist/face-info/derive.d.ts

@@ -0,0 +1,8 @@
+import { Category, NormalizedLandmark } from '@mediapipe/tasks-vision';
+import { FaceBlendshapeName } from './blendshapes';
+import { FaceInfo } from './types';
+export declare const DEFAULT_FACE_EXPRESSION_THRESHOLD = 0.5;
+export declare const writeFaceBlendshapes: (categories: readonly Category[] | undefined, target: Record<string, number>) => Record<string, number>;
+export declare const getFaceBlendshape: (faceInfo: FaceInfo, name: FaceBlendshapeName) => number;
+export declare const hasFaceExpression: (faceInfo: FaceInfo, name: FaceBlendshapeName, threshold?: number) => boolean;
+export declare const getFaceEyeDistance: (landmarks: readonly NormalizedLandmark[]) => number;

package/dist/face-info/drawFaceCrop.d.ts

@@ -0,0 +1,10 @@
+import { CropOutputSize } from '../utils/drawNormalizedCrop';
+import { FaceInfo } from './types';
+export type DrawFaceCropOptions = {
+    source: CanvasImageSource;
+    face: FaceInfo;
+    canvas: HTMLCanvasElement;
+    outputSize: CropOutputSize;
+    padding?: number;
+};
+export declare const drawFaceCrop: ({ source, face, canvas, outputSize, padding, }: DrawFaceCropOptions) => boolean;

package/dist/face-info/getFaceInfo.d.ts

@@ -0,0 +1,8 @@
+import { FaceLandmarkerResult } from '@mediapipe/tasks-vision';
+import { XRModelNodeFaceTracking } from '../types/nodes';
+import { FaceInfo, FaceInfoTarget } from './types';
+/** Creates reusable storage for allocation-free `getFaceInfo` reads in `useFrame`. */
+export declare const createFaceInfoTarget: () => FaceInfoTarget;
+export declare const getFaceInfoFromResults: (node: XRModelNodeFaceTracking, results: FaceLandmarkerResult, faceIndex?: number, target?: FaceInfoTarget) => FaceInfo | null;
+/** Reads the current face. Pass a reusable target on per-frame hot paths. */
+export declare const getFaceInfo: (node: XRModelNodeFaceTracking, faceIndex?: number, target?: FaceInfoTarget) => FaceInfo | null;

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

@@ -0,0 +1,8 @@
+export { DEFAULT_FACE_EXPRESSION_THRESHOLD, getFaceBlendshape, getFaceEyeDistance, hasFaceExpression, } from './derive';
+export { FACE_BLENDSHAPE_NAMES } from './blendshapes';
+export { createFaceInfoTarget, getFaceInfo } from './getFaceInfo';
+export { drawFaceCrop } from './drawFaceCrop';
+export type { DrawFaceCropOptions } from './drawFaceCrop';
+export { FACE_LANDMARK_INDICES } from './landmarks';
+export type { FaceBlendshapeName } from './blendshapes';
+export type { FaceInfo, FaceInfoTarget, FaceVector3 } from './types';

package/dist/face-info/landmarks.d.ts

@@ -0,0 +1,21 @@
+import { NormalizedLandmark } from '@mediapipe/tasks-vision';
+import { FaceCustomAnchorPoint, FaceTarget } from '../types/tracking';
+/** MediaPipe canonical face-mesh indices. Left/right follow the person's perspective. */
+export declare const FACE_LANDMARK_INDICES: {
+    readonly "face.forehead": 10;
+    readonly "face.noseTip": 1;
+    readonly "face.chin": 152;
+    readonly "face.leftEyeOuter": 263;
+    readonly "face.rightEyeOuter": 33;
+    readonly "face.leftCheek": 425;
+    readonly "face.rightCheek": 205;
+    readonly "face.mouthCenter": 13;
+    readonly "face.leftEarlobe": 454;
+    readonly "face.rightEarlobe": 234;
+};
+/** Resolves a semantic face target in normalized tracker-input coordinates. */
+export declare const resolveFaceAnchorPoint: (faceTarget: FaceTarget, landmarks: readonly NormalizedLandmark[], customAnchorPoint?: FaceCustomAnchorPoint, target?: NormalizedLandmark) => NormalizedLandmark | null;
+export declare const FACE_EYE_DISTANCE_LANDMARKS: {
+    readonly left: 263;
+    readonly right: 33;
+};

package/dist/face-info/types.d.ts

@@ -0,0 +1,52 @@
+import { NormalizedLandmark } from '@mediapipe/tasks-vision';
+import { FaceBounds } from '../types/face';
+import { FaceBlendshapeName } from './blendshapes';
+export type FaceVector3 = Readonly<{
+    x: number;
+    y: number;
+    z: number;
+}>;
+export type FaceInfo = {
+    /** Current result-array index. This is not a persistent identity. */
+    readonly index: number;
+    /** MediaPipe landmarks in normalized tracker-input coordinates; top-left origin. */
+    readonly landmarks: readonly NormalizedLandmark[];
+    /** Axis-aligned bounds in the same normalized tracker-input coordinates. */
+    readonly bounds: Readonly<FaceBounds>;
+    readonly pose: {
+        /** Three.js world position from the existing face tracker. */
+        readonly position: FaceVector3;
+        /** Radians: X pitch (+up), Y yaw (+left), Z roll. */
+        readonly rotation: FaceVector3;
+        /** Smoothed uniform sizing heuristic used by the face occluder/tracker anchor. */
+        readonly scale: FaceVector3;
+    };
+    /** Outer-eye distance in normalized tracker-input coordinates. */
+    readonly eyeDistance: number;
+    /** MediaPipe blendshape category names mapped to scores in [0, 1]. */
+    readonly blendshapes: Readonly<Partial<Record<FaceBlendshapeName, number>>>;
+};
+export type FaceInfoTarget = {
+    index: number;
+    landmarks: readonly NormalizedLandmark[];
+    bounds: FaceBounds;
+    pose: {
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        rotation: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        scale: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    };
+    eyeDistance: number;
+    blendshapes: Record<string, number>;
+};

package/dist/getFaceInfo-CyPAKh3h.cjs

@@ -0,0 +1 @@
+"use strict";const x=require("react"),b=require("./index-82aENaRq.cjs"),E=(e,t={minX:0,minY:0,maxX:0,maxY:0,width:0,height:0,centerX:0,centerY:0})=>{if(e.length===0)return t.minX=0,t.minY=0,t.maxX=0,t.maxY=0,t.width=0,t.height=0,t.centerX=0,t.centerY=0,t;let n=1,s=1,i=0,o=0;for(let l=0;l<e.length;l++){const{x:a,y:r}=e[l];a<n&&(n=a),r<s&&(s=r),a>i&&(i=a),r>o&&(o=r)}const c=Math.max(0,i-n),u=Math.max(0,o-s);return t.minX=n,t.minY=s,t.maxX=i,t.maxY=o,t.width=c,t.height=u,t.centerX=n+c*.5,t.centerY=s+u*.5,t},_=(e,t)=>e.map(n=>({landmarks:n,bounds:E(n)})),C={publishedCount:0,lastPublishAt:-1/0,lastNonEmptyAt:-1},I=(e,t,n,s,i)=>{if(t>0){const o={...e,lastNonEmptyAt:n};return n-e.lastPublishAt>=s?{action:"publish",state:{publishedCount:t,lastPublishAt:n,lastNonEmptyAt:n}}:{action:"none",state:o}}return e.publishedCount===0?{action:"none",state:e}:e.lastNonEmptyAt>=0&&n-e.lastNonEmptyAt<i?{action:"none",state:e}:{action:"clear",state:{publishedCount:0,lastPublishAt:-1/0,lastNonEmptyAt:e.lastNonEmptyAt}}},L=({enabled:e,holdMs:t,node:n,onFrame:s,prepare:i,throttleMs:o})=>{const[c,u]=x.useState([]);return x.useEffect(()=>{if(!e||!n){u(h=>h.length===0?h:[]);return}let l=0,a,r=C;const d=(h,m,f)=>{const{action:A,state:S}=I(r,h,m,o,t);r=S,A==="publish"?u(f):A==="clear"&&u(y=>y.length===0?y:[])},F=()=>{l=requestAnimationFrame(F),s==null||s();const h=performance.now(),m=n.getDetectionResults();if(!m){d(0,h,[]),a=m;return}if(m===a)return;a=m;const f=i(m);d(f.length,h,f)};return l=requestAnimationFrame(F),()=>cancelAnimationFrame(l)},[e,t,n,s,i,o]),c},R=.5,P=(e,t)=>{for(const n in t)delete t[n];if(e)for(const n of e)t[n.categoryName]=n.score;return t},X=(e,t)=>e.blendshapes[t]??0,T=(e,t,n=R)=>X(e,t)>=n,Y=e=>{const t=e[b.FACE_EYE_DISTANCE_LANDMARKS.left],n=e[b.FACE_EYE_DISTANCE_LANDMARKS.right];return!t||!n?0:Math.hypot(t.x-n.x,t.y-n.y)},D=()=>({index:0,landmarks:[],bounds:{minX:0,minY:0,maxX:0,maxY:0,width:0,height:0,centerX:0,centerY:0},pose:{position:{x:0,y:0,z:0},rotation:{x:0,y:0,z:0},scale:{x:0,y:0,z:0}},eyeDistance:0,blendshapes:{}}),p=(e,t)=>{t.x=e.x,t.y=e.y,t.z=e.z},N=(e,t,n=0,s)=>{var u,l,a;const i=(u=t.faceLandmarks)==null?void 0:u[n],o=e.getFace(n);if(!i||!o)return null;const c=s??D();return c.index=n,c.landmarks=i,E(i,c.bounds),p(o.transform.position,c.pose.position),p(o.transform.rotation,c.pose.rotation),p(o.transform.scale,c.pose.scale),c.eyeDistance=Y(i),P((a=(l=t.faceBlendshapes)==null?void 0:l[n])==null?void 0:a.categories,c.blendshapes),c},B=(e,t=0,n)=>{const s=e.getDetectionResults();return s?N(e,s,t,n):null};exports.DEFAULT_FACE_EXPRESSION_THRESHOLD=R;exports.computeLandmarkBounds=E;exports.createFaceInfoTarget=D;exports.getFaceBlendshape=X;exports.getFaceEyeDistance=Y;exports.getFaceInfo=B;exports.getFaceInfoFromResults=N;exports.hasFaceExpression=T;exports.prepareCalibrationFaceResults=_;exports.useFaceResultReader=L;

package/dist/getFaceInfo-hUKMLFcr.js

@@ -0,0 +1,118 @@
+import { useState as X, useEffect as Y } from "react";
+import { F as A } from "./index-BgQAX8rs.js";
+const E = (e, t = {
+  minX: 0,
+  minY: 0,
+  maxX: 0,
+  maxY: 0,
+  width: 0,
+  height: 0,
+  centerX: 0,
+  centerY: 0
+}) => {
+  if (e.length === 0)
+    return t.minX = 0, t.minY = 0, t.maxX = 0, t.maxY = 0, t.width = 0, t.height = 0, t.centerX = 0, t.centerY = 0, t;
+  let n = 1, s = 1, i = 0, o = 0;
+  for (let l = 0; l < e.length; l++) {
+    const { x: c, y: r } = e[l];
+    c < n && (n = c), r < s && (s = r), c > i && (i = c), r > o && (o = r);
+  }
+  const a = Math.max(0, i - n), u = Math.max(0, o - s);
+  return t.minX = n, t.minY = s, t.maxX = i, t.maxY = o, t.width = a, t.height = u, t.centerX = n + a * 0.5, t.centerY = s + u * 0.5, t;
+}, L = (e, t) => e.map((n) => ({
+  landmarks: n,
+  bounds: E(n)
+})), D = {
+  publishedCount: 0,
+  // -Infinity, not 0: the first non-empty frame must publish regardless of its
+  // timestamp (a frame at now=0 would otherwise be throttled against 0).
+  lastPublishAt: -1 / 0,
+  lastNonEmptyAt: -1
+}, N = (e, t, n, s, i) => {
+  if (t > 0) {
+    const o = { ...e, lastNonEmptyAt: n };
+    return n - e.lastPublishAt >= s ? {
+      action: "publish",
+      state: { publishedCount: t, lastPublishAt: n, lastNonEmptyAt: n }
+    } : { action: "none", state: o };
+  }
+  return e.publishedCount === 0 ? { action: "none", state: e } : e.lastNonEmptyAt >= 0 && n - e.lastNonEmptyAt < i ? { action: "none", state: e } : {
+    action: "clear",
+    // Reset the throttle anchor so the next reacquired face publishes at once.
+    state: { publishedCount: 0, lastPublishAt: -1 / 0, lastNonEmptyAt: e.lastNonEmptyAt }
+  };
+}, B = ({
+  enabled: e,
+  holdMs: t,
+  node: n,
+  onFrame: s,
+  prepare: i,
+  throttleMs: o
+}) => {
+  const [a, u] = X([]);
+  return Y(() => {
+    if (!e || !n) {
+      u((h) => h.length === 0 ? h : []);
+      return;
+    }
+    let l = 0, c, r = D;
+    const d = (h, m, f) => {
+      const { action: x, state: F } = N(r, h, m, o, t);
+      r = F, x === "publish" ? u(f) : x === "clear" && u((b) => b.length === 0 ? b : []);
+    }, y = () => {
+      l = requestAnimationFrame(y), s == null || s();
+      const h = performance.now(), m = n.getDetectionResults();
+      if (!m) {
+        d(0, h, []), c = m;
+        return;
+      }
+      if (m === c) return;
+      c = m;
+      const f = i(m);
+      d(f.length, h, f);
+    };
+    return l = requestAnimationFrame(y), () => cancelAnimationFrame(l);
+  }, [e, t, n, s, i, o]), a;
+}, R = 0.5, S = (e, t) => {
+  for (const n in t) delete t[n];
+  if (e)
+    for (const n of e) t[n.categoryName] = n.score;
+  return t;
+}, C = (e, t) => e.blendshapes[t] ?? 0, T = (e, t, n = R) => C(e, t) >= n, P = (e) => {
+  const t = e[A.left], n = e[A.right];
+  return !t || !n ? 0 : Math.hypot(t.x - n.x, t.y - n.y);
+}, _ = () => ({
+  index: 0,
+  landmarks: [],
+  bounds: { minX: 0, minY: 0, maxX: 0, maxY: 0, width: 0, height: 0, centerX: 0, centerY: 0 },
+  pose: {
+    position: { x: 0, y: 0, z: 0 },
+    rotation: { x: 0, y: 0, z: 0 },
+    scale: { x: 0, y: 0, z: 0 }
+  },
+  eyeDistance: 0,
+  blendshapes: {}
+}), p = (e, t) => {
+  t.x = e.x, t.y = e.y, t.z = e.z;
+}, w = (e, t, n = 0, s) => {
+  var u, l, c;
+  const i = (u = t.faceLandmarks) == null ? void 0 : u[n], o = e.getFace(n);
+  if (!i || !o) return null;
+  const a = s ?? _();
+  return a.index = n, a.landmarks = i, E(i, a.bounds), p(o.transform.position, a.pose.position), p(o.transform.rotation, a.pose.rotation), p(o.transform.scale, a.pose.scale), a.eyeDistance = P(i), S((c = (l = t.faceBlendshapes) == null ? void 0 : l[n]) == null ? void 0 : c.categories, a.blendshapes), a;
+}, q = (e, t = 0, n) => {
+  const s = e.getDetectionResults();
+  return s ? w(e, s, t, n) : null;
+};
+export {
+  R as D,
+  C as a,
+  P as b,
+  E as c,
+  _ as d,
+  q as e,
+  w as g,
+  T as h,
+  L as p,
+  B as u
+};

package/dist/{handJoints2d.d.ts → hand/handJoints2d.d.ts}

@@ -1,4 +1,4 @@
-import { XRModelNodeHandTracking } from './types/nodes';
+import { XRModelNodeHandTracking } from '../types/nodes';
 export type HandJoints2DSettings = {
     enabled: boolean;
     bothHands: boolean;

package/dist/{handTracking2d.d.ts → hand/handTracking2d.d.ts}

@@ -1,4 +1,4 @@
-import { XRModelNodeHandTracking } from './types/nodes';
+import { XRModelNodeHandTracking } from '../types/nodes';
 export type HandTracking2DSettings = {
     enabled: boolean;
     bothHands: boolean;

package/dist/{handTracking2dController.d.ts → hand/handTracking2dController.d.ts}

@@ -1,4 +1,4 @@
-import { XRModelNodeHandTracking } from './types/nodes';
+import { XRModelNodeHandTracking } from '../types/nodes';
 export type HandTracking2DControllerSettings = {
     enabled: boolean;
     attachImageEnabled: boolean;

package/dist/{handTracking3d.d.ts → hand/handTracking3d.d.ts}

@@ -1,4 +1,4 @@
-import { XRModelNodeHandTracking } from './types/nodes';
+import { XRModelNodeHandTracking } from '../types/nodes';
 export type HandTracking3DSettings = {
     enabled: boolean;
     bothHands: boolean;

package/dist/hooks/faceResults.d.ts

@@ -7,7 +7,7 @@ export type CalibrationMediaSourceKind = "webcam" | XRMediaSourceKind;
  * `FaceTrackingResult`s (landmarks + axis-aligned bounds). Source-kind is
  * accepted for future per-source handling; results stay in display space.
  */
-export declare const prepareCalibrationFaceResults: (faceLandmarks: NormalizedLandmark[][], _selectedSource: CalibrationMediaSourceKind) => FaceTrackingResult[];
+export declare const prepareCalibrationFaceResults: (faceLandmarks: NormalizedLandmark[][], selectedSource: CalibrationMediaSourceKind) => FaceTrackingResult[];
 /**
  * Per-frame publish state for the face-results reader. Pure so the hold +
  * throttle timing can be unit-tested without a RAF/React harness.

package/dist/hooks/useCalibrationFaceTracker.d.ts

@@ -18,6 +18,6 @@ export declare const useCalibrationFaceTracker: ({ enabled, displayMirrored, ima
 }) => {
     activeDelegate: "GPU";
     faces: import('../types').FaceTrackingResult[];
-    status: "error" | "idle" | "ready" | "initializing";
+    status: "idle" | "ready" | "error" | "initializing";
     error: string | null;
 };

package/dist/hooks/useFaceAction.d.ts

@@ -0,0 +1,3 @@
+import { FaceActionName, FaceActionOptions, FaceActionState } from '../face-action';
+import { FaceInfo } from '../face-info';
+export declare const useFaceAction: (face: FaceInfo | null, action: FaceActionName, options?: FaceActionOptions) => FaceActionState;

package/dist/hooks/useFaceAttributeExpression.d.ts

@@ -0,0 +1,16 @@
+import { FaceAttributeExpressionResult } from '../face-attribute-expression';
+import { FaceInfo } from '../face-info';
+export declare const DEFAULT_FACE_ATTRIBUTE_EXPRESSION_MODEL_URL = "https://huggingface.co/opencv/facial_expression_recognition/resolve/main/facial_expression_recognition_mobilefacenet_2022july_int8.onnx";
+export type FaceAttributeExpressionStatus = "idle" | "loading" | "ready" | "error";
+export type UseFaceAttributeExpressionOptions = {
+    active?: boolean;
+    targetFps?: number;
+    minConfidence?: number;
+    modelUrl?: string;
+};
+export type UseFaceAttributeExpressionResult = {
+    status: FaceAttributeExpressionStatus;
+    result: FaceAttributeExpressionResult | null;
+    error: Error | null;
+};
+export declare const useFaceAttributeExpression: (face: FaceInfo | null, { active, targetFps, minConfidence, modelUrl, }?: UseFaceAttributeExpressionOptions) => UseFaceAttributeExpressionResult;

package/dist/hooks/useFaceDetection.d.ts

@@ -0,0 +1,18 @@
+import { FaceInfo } from '../face-info';
+import { UseFaceInfosOptions } from './useFaceInfos';
+export type FaceDetectionPhase = "begin" | "stay" | "end" | "none";
+export type UseFaceDetectionOptions = UseFaceInfosOptions & {
+    faceIndex?: number;
+};
+export type FaceDetectionState = {
+    face: FaceInfo | null;
+    faces: FaceInfo[];
+    faceCount: number;
+    detected: boolean;
+    justDetected: boolean;
+    justLost: boolean;
+    phase: FaceDetectionPhase;
+};
+export declare const getFaceDetectionPhase: (wasDetected: boolean, detected: boolean) => FaceDetectionPhase;
+/** Face presence/count lifecycle over the shared FaceInfo reader. */
+export declare const useFaceDetection: ({ faceIndex, numFaces, ...options }?: UseFaceDetectionOptions) => FaceDetectionState;

package/dist/hooks/useFaceInfo.d.ts

@@ -0,0 +1,7 @@
+import { FaceInfo } from '../face-info';
+import { UseFaceInfosOptions } from './useFaceInfos';
+export type UseFaceInfoOptions = UseFaceInfosOptions & {
+    faceIndex?: number;
+};
+/** Single-face selector over `useFaceInfos`; it does not create another reader loop. */
+export declare const useFaceInfo: ({ faceIndex, numFaces, ...options }?: UseFaceInfoOptions) => FaceInfo | null;

package/dist/hooks/useFaceInfos.d.ts

@@ -0,0 +1,15 @@
+import { FaceInfo } from '../face-info';
+export type UseFaceInfosOptions = {
+    /** Pauses this consumer's model interest when false. Default true. */
+    active?: boolean;
+    /** Maximum faces requested from the shared model. Default 1. */
+    numFaces?: number;
+    /** Optional inference-rate cap. */
+    targetFps?: number;
+    /** Minimum milliseconds between React result publications. Default 16. */
+    throttleMs?: number;
+    /** Keep the last result through brief missed detections. Default 250. */
+    holdMs?: number;
+};
+/** React reader for all current faces. Must run inside XRProvider and the R3F Canvas. */
+export declare const useFaceInfos: ({ active, holdMs, numFaces, targetFps, throttleMs, }?: UseFaceInfosOptions) => FaceInfo[];

package/dist/hooks/useFaceResultReader.d.ts

@@ -0,0 +1,10 @@
+import { FaceLandmarkerResult } from '@mediapipe/tasks-vision';
+import { XRModelNodeFaceTracking } from '../types/nodes';
+export declare const useFaceResultReader: <T>({ enabled, holdMs, node, onFrame, prepare, throttleMs, }: {
+    node: XRModelNodeFaceTracking | null;
+    enabled: boolean;
+    throttleMs: number;
+    holdMs: number;
+    onFrame?: () => void;
+    prepare: (results: FaceLandmarkerResult) => T[];
+}) => T[];

package/dist/hooks/useFrameCapture.d.ts

@@ -0,0 +1,18 @@
+export type CaptureStatus = "idle" | "capturing" | "completed" | "error";
+export type FrameCaptureEvents = {
+    onCaptureStart?: () => void;
+    onCaptureComplete?: (dataUrl: string) => void;
+    onError?: (error: Error) => void;
+};
+export type UseFrameCaptureOptions = FrameCaptureEvents & {
+    /** Override the XR session capture function for custom renderers or tests. */
+    captureFrame?: () => string;
+};
+export declare const runFrameCapture: (captureFrame: () => string, events?: FrameCaptureEvents) => Promise<string>;
+export declare const useFrameCapture: (options?: UseFrameCaptureOptions) => {
+    status: CaptureStatus;
+    capturePhoto: () => Promise<string | null>;
+    clear: () => void;
+    dataUrl: string | null;
+    error: Error | null;
+};

package/dist/hooks/useMediaRecorder.d.ts

@@ -1,3 +1,7 @@
+export type RecordingStatus = "idle" | "starting" | "recording" | "paused" | "stopping" | "completed" | "error";
+export type RecordingEvent = "start" | "started" | "pause" | "resume" | "stop" | "complete" | "fail" | "clear";
+/** Pure lifecycle mapping, exported so apps and tests can share the SDK convention. */
+export declare const recordingStatusForEvent: (event: RecordingEvent) => RecordingStatus;
 export interface UseMediaRecorderOptions {
     /**
      * Add an audio track to the recording. `true` opens the default microphone;
@@ -10,7 +14,14 @@ export interface UseMediaRecorderOptions {
     mimeType?: string;
     bitsPerSecond?: number;
     onData?: (chunk: Blob) => void;
+    /** @deprecated Use `onRecordingComplete`. */
     onStop?: (blob: Blob) => void;
+    onRecordingStart?: () => void;
+    onRecordingPause?: () => void;
+    onRecordingResume?: () => void;
+    onRecordingStop?: () => void;
+    onRecordingComplete?: (blob: Blob) => void;
+    onError?: (error: Error) => void;
     /**
      * Record this exact stream as-is (no track assembly, no getUserMedia). Use
      * when you've already composed the stream you want (e.g. canvas + music).
@@ -24,10 +35,11 @@ export interface UseMediaRecorderOptions {
  * input, plus an optional audio track per `audio` — picks the first supported
  * codec, and begins recording. `stop()` finalizes; the `Blob` lands on
  * `recordedBlob` (and `onStop`). Pass `passThroughStream` to record a
- * pre-composed stream verbatim.
+ * pre-composed stream verbatim, then call `start()` without an argument.
  */
 export declare function useMediaRecorder(opts?: UseMediaRecorderOptions): {
-    start: (inputStream: MediaStream, timeslice?: number) => Promise<void>;
+    status: RecordingStatus;
+    start: (inputStream?: MediaStream, timeslice?: number) => Promise<void>;
     stop: () => void;
     pause: () => void;
     resume: () => void;

package/dist/hooks/useOwnedTexture.d.ts

@@ -0,0 +1,6 @@
+import { Texture } from 'three';
+/**
+ * Own a texture for exactly as long as the current React binding uses it.
+ * Replacement disposes the previous texture; unmount disposes the final one.
+ */
+export declare const useOwnedTexture: (texture: Texture | null | undefined) => void;

package/dist/hooks/useTrackerContext.d.ts

@@ -1,4 +1,4 @@
-import { TrackerType, TrackingTarget } from '../types/tracking';
+import { FaceCustomAnchorPoint, TrackerType, TrackingTarget } from '../types/tracking';
 import * as THREE from "three";
 /**
  * Per-frame resolver for a tracker's landmarks/joints.
@@ -12,7 +12,7 @@ import * as THREE from "three";
  * Returning `null` means "this landmark is not currently detected" —
  * the anchor should hide its children for that frame.
  */
-export type TrackerLandmarkResolver = (target: TrackingTarget) => {
+export type TrackerLandmarkResolver = (target: TrackingTarget, customAnchorPoint?: FaceCustomAnchorPoint) => {
     position: THREE.Vector3;
     quaternion?: THREE.Quaternion;
 } | null;

package/dist/hooks/useXRSession/facade.d.ts

@@ -15,13 +15,16 @@ export type SessionFacade = {
     registerXRPipeline: (params: RegisterXRPipelineParams) => Promise<void>;
     getModelNode: <T extends Record<string, unknown>>(modelCode: XRModel) => T;
     captureFrame: () => string;
+    getInputFrame: () => OffscreenCanvas | HTMLCanvasElement | null;
     _setRenderTarget: (canvas: HTMLCanvasElement) => Promise<void>;
     _setRenderSize: (width: number, height: number) => Promise<void>;
     _setR3FState: (state: {
         renderer: WebGLRenderer;
         scene: Scene;
         camera: Camera;
+        renderFrame?: () => void;
     }) => void;
+    _renderFrame: () => void;
     _getVideoElement: () => HTMLVideoElement | undefined;
     /** Update the session perf config (targetFps / camRes). Applied to models on
      *  their next run; camRes takes effect on the next media (re)bind. */

package/dist/hooks/useXRSession/registry.d.ts

@@ -25,6 +25,15 @@ export type ModelRegistry = {
      * always-on behavior.
      */
     setActive: (modelName: XRModel, ownerId: string, active: boolean) => void;
+    /**
+     * Pause every model without changing owner activity. Used when the session is
+     * stopped or a static source has completed its one-shot detection pulse.
+     */
+    suspendAll: () => void;
+    /**
+     * Clear session suspension and resume only models with active owners.
+     */
+    resumeActive: () => void;
     /**
      * Direct accessor — returns the registered model instance, or undefined.
      * Does NOT throw. The session facade's `getModelNode` wraps this with the

package/dist/index-82aENaRq.cjs

@@ -0,0 +1 @@
+"use strict";const _=require("react/jsx-runtime"),v=require("@react-three/fiber"),s=require("react"),S=require("./index-D4bLzBr6.cjs"),X=require("./renderLayers-lDtL0_43.cjs"),V=require("three");function Y(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const n in e)if(n!=="default"){const r=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,r.get?r:{enumerable:!0,get:()=>e[n]})}}return t.default=e,Object.freeze(t)}const b=Y(V);function N(e,t,n=!0){const{session:r}=S.useXRContext(),o=s.useId(),[u,d]=s.useState(null),l=s.useMemo(()=>JSON.stringify(t??{}),[t]);s.useEffect(()=>{let f=!1;return d(null),r.registry.acquire(e,o,t).catch(i=>{f||d(i instanceof Error?i:new Error(String(i)))}),()=>{f=!0,r.registry.release(e,o)}},[r,e,o,t,l]),s.useEffect(()=>{r.registry.setActive(e,o,n)},[r,e,o,n]);const c=r.store,h=s.useSyncExternalStore(f=>c.subscribe(f),()=>c.getSnapshot().pipeline.get(e)??null,()=>null),p=s.useMemo(()=>h?h.getModelNode():null,[h]);return{ready:h!==null&&u===null,node:p,error:u}}const U=({materialProps:e,settings:t})=>t.type==="basic"?_.jsx("meshBasicMaterial",{...e}):_.jsx("meshStandardMaterial",{...e,roughness:t.roughness,metalness:t.metalness}),j=1e-6,Z=e=>{const{x:t,y:n,z:r}=e.scale;return Math.abs(t-n)<=j&&Math.abs(t-r)<=j?t:1},B=(e,t,n,r)=>{if(!n.enabled)return e;const o=Z(n);return r.x=t.x+(e.x-t.x)*o+n.position.x,r.y=t.y+(e.y-t.y)*o-n.position.y,r.z=t.z+(e.z-t.z)*o+n.position.z,r},W=(e,t,n)=>S.unprojectToZZeroInto(e,t,n),G=(e,t,n)=>{const r=(e.x-.5)*2,o=(.5-e.y)*2,u=b.MathUtils.clamp(e.z*2,-1,1);return n.set(r,o,u).unproject(t)},J=(e,t,n,r,o,u)=>{const d=Math.min(t,e.length);for(let l=0;l<d;l++){o(e[l],r,u);const c=l*3;n[c]=u.x,n[c+1]=u.y,n[c+2]=u.z}return d},Q=[[127,34,139],[11,0,37],[232,231,120],[72,37,39],[128,121,47],[232,121,128],[104,69,67],[175,171,148],[118,50,101],[73,39,40],[9,151,108],[48,115,131],[194,204,211],[74,40,185],[80,42,183],[40,92,186],[230,229,118],[202,212,214],[83,18,17],[76,61,146],[160,29,30],[56,157,173],[106,204,194],[135,214,192],[203,165,98],[21,71,68],[51,45,4],[144,24,23],[77,146,91],[205,50,187],[201,200,18],[91,106,182],[90,91,181],[85,84,17],[206,203,36],[148,171,140],[92,40,39],[193,189,244],[159,158,28],[247,246,161],[236,3,196],[54,68,104],[193,168,8],[117,228,31],[189,193,55],[98,97,99],[126,47,100],[166,79,218],[155,154,26],[209,49,131],[135,136,150],[47,126,217],[223,52,53],[45,51,134],[211,170,140],[67,69,108],[43,106,91],[230,119,120],[226,130,247],[63,53,52],[238,20,242],[46,70,156],[78,62,96],[46,53,63],[143,34,227],[123,117,111],[44,125,19],[236,134,51],[216,206,205],[154,153,22],[39,37,167],[200,201,208],[36,142,100],[57,212,202],[20,60,99],[28,158,157],[35,226,113],[160,159,27],[204,202,210],[113,225,46],[43,202,204],[62,76,77],[137,123,116],[41,38,72],[203,129,142],[64,98,240],[49,102,64],[41,73,74],[212,216,207],[42,74,184],[169,170,211],[170,149,176],[105,66,69],[122,6,168],[123,147,187],[96,77,90],[65,55,107],[89,90,180],[101,100,120],[63,105,104],[93,137,227],[15,86,85],[129,102,49],[14,87,86],[55,8,9],[100,47,121],[145,23,22],[88,89,179],[6,122,196],[88,95,96],[138,172,136],[215,58,172],[115,48,219],[42,80,81],[195,3,51],[43,146,61],[171,175,199],[81,82,38],[53,46,225],[144,163,110],[52,65,66],[229,228,117],[34,127,234],[107,108,69],[109,108,151],[48,64,235],[62,78,191],[129,209,126],[111,35,143],[117,123,50],[222,65,52],[19,125,141],[221,55,65],[3,195,197],[25,7,33],[220,237,44],[70,71,139],[122,193,245],[247,130,33],[71,21,162],[170,169,150],[188,174,196],[216,186,92],[2,97,167],[141,125,241],[164,167,37],[72,38,12],[38,82,13],[63,68,71],[226,35,111],[101,50,205],[206,92,165],[209,198,217],[165,167,97],[220,115,218],[133,112,243],[239,238,241],[214,135,169],[190,173,133],[171,208,32],[125,44,237],[86,87,178],[85,86,179],[84,85,180],[83,84,181],[201,83,182],[137,93,132],[76,62,183],[61,76,184],[57,61,185],[212,57,186],[214,207,187],[34,143,156],[79,239,237],[123,137,177],[44,1,4],[201,194,32],[64,102,129],[213,215,138],[59,166,219],[242,99,97],[2,94,141],[75,59,235],[24,110,228],[25,130,226],[23,24,229],[22,23,230],[26,22,231],[112,26,232],[189,190,243],[221,56,190],[28,56,221],[27,28,222],[29,27,223],[30,29,224],[247,30,225],[238,79,20],[166,59,75],[60,75,240],[147,177,215],[20,79,166],[187,147,213],[112,233,244],[233,128,245],[128,114,188],[114,217,174],[131,115,220],[217,198,236],[198,131,134],[177,132,58],[143,35,124],[110,163,7],[228,110,25],[356,389,368],[11,302,267],[452,350,349],[302,303,269],[357,343,277],[452,453,357],[333,332,297],[175,152,377],[347,348,330],[303,304,270],[9,336,337],[278,279,360],[418,262,431],[304,408,409],[310,415,407],[270,409,410],[450,348,347],[422,430,434],[313,314,17],[306,307,375],[387,388,260],[286,414,398],[335,406,418],[364,367,416],[423,358,327],[251,284,298],[281,5,4],[373,374,253],[307,320,321],[425,427,411],[421,313,18],[321,405,406],[320,404,405],[315,16,17],[426,425,266],[377,400,369],[322,391,269],[417,465,464],[386,257,258],[466,260,388],[456,399,419],[284,332,333],[417,285,8],[346,340,261],[413,441,285],[327,460,328],[355,371,329],[392,439,438],[382,341,256],[429,420,360],[364,394,379],[277,343,437],[443,444,283],[275,440,363],[431,262,369],[297,338,337],[273,375,321],[450,451,349],[446,342,467],[293,334,282],[458,461,462],[276,353,383],[308,324,325],[276,300,293],[372,345,447],[352,345,340],[274,1,19],[456,248,281],[436,427,425],[381,256,252],[269,391,393],[200,199,428],[266,330,329],[287,273,422],[250,462,328],[258,286,384],[265,353,342],[387,259,257],[424,431,430],[342,353,276],[273,335,424],[292,325,307],[366,447,345],[271,303,302],[423,266,371],[294,455,460],[279,278,294],[271,272,304],[432,434,427],[272,407,408],[394,430,431],[395,369,400],[334,333,299],[351,417,168],[352,280,411],[325,319,320],[295,296,336],[319,403,404],[330,348,349],[293,298,333],[323,454,447],[15,16,315],[358,429,279],[14,15,316],[285,336,9],[329,349,350],[374,380,252],[318,402,403],[6,197,419],[318,319,325],[367,364,365],[435,367,397],[344,438,439],[272,271,311],[195,5,281],[273,287,291],[396,428,199],[311,271,268],[283,444,445],[373,254,339],[282,334,296],[449,347,346],[264,447,454],[336,296,299],[338,10,151],[278,439,455],[292,407,415],[358,371,355],[340,345,372],[346,347,280],[442,443,282],[19,94,370],[441,442,295],[248,419,197],[263,255,359],[440,275,274],[300,383,368],[351,412,465],[263,467,466],[301,368,389],[395,378,379],[412,351,419],[436,426,322],[2,164,393],[370,462,461],[164,0,267],[302,11,12],[268,12,13],[293,300,301],[446,261,340],[330,266,425],[426,423,391],[429,355,437],[391,327,326],[440,457,438],[341,382,362],[459,457,461],[434,430,394],[414,463,362],[396,369,262],[354,461,457],[316,403,402],[315,404,403],[314,405,404],[313,406,405],[421,418,406],[366,401,361],[306,408,407],[291,409,408],[287,410,409],[432,436,410],[434,416,411],[264,368,383],[309,438,457],[352,376,401],[274,275,4],[421,428,262],[294,327,358],[433,416,367],[289,455,439],[462,370,326],[2,326,370],[305,460,455],[254,449,448],[255,261,446],[253,450,449],[252,451,450],[256,452,451],[341,453,452],[413,464,463],[441,413,414],[258,442,441],[257,443,442],[259,444,443],[260,445,444],[467,342,445],[459,458,250],[289,392,290],[290,328,460],[376,433,435],[250,290,392],[411,416,433],[341,463,464],[453,464,465],[357,465,412],[343,412,399],[360,363,440],[437,399,456],[420,456,363],[401,435,288],[372,383,353],[339,255,249],[448,261,255],[133,243,190],[133,155,112],[33,246,247],[33,130,25],[398,384,286],[362,398,414],[362,463,341],[263,359,467],[263,249,255],[466,467,260],[75,60,166],[238,239,79],[162,127,139],[72,11,37],[121,232,120],[73,72,39],[114,128,47],[233,232,128],[103,104,67],[152,175,148],[119,118,101],[74,73,40],[107,9,108],[49,48,131],[32,194,211],[184,74,185],[191,80,183],[185,40,186],[119,230,118],[210,202,214],[84,83,17],[77,76,146],[161,160,30],[190,56,173],[182,106,194],[138,135,192],[129,203,98],[54,21,68],[5,51,4],[145,144,23],[90,77,91],[207,205,187],[83,201,18],[181,91,182],[180,90,181],[16,85,17],[205,206,36],[176,148,140],[165,92,39],[245,193,244],[27,159,28],[30,247,161],[174,236,196],[103,54,104],[55,193,8],[111,117,31],[221,189,55],[240,98,99],[142,126,100],[219,166,218],[112,155,26],[198,209,131],[169,135,150],[114,47,217],[224,223,53],[220,45,134],[32,211,140],[109,67,108],[146,43,91],[231,230,120],[113,226,247],[105,63,52],[241,238,242],[124,46,156],[95,78,96],[70,46,63],[116,143,227],[116,123,111],[1,44,19],[3,236,51],[207,216,205],[26,154,22],[165,39,167],[199,200,208],[101,36,100],[43,57,202],[242,20,99],[56,28,157],[124,35,113],[29,160,27],[211,204,210],[124,113,46],[106,43,204],[96,62,77],[227,137,116],[73,41,72],[36,203,142],[235,64,240],[48,49,64],[42,41,74],[214,212,207],[183,42,184],[210,169,211],[140,170,176],[104,105,69],[193,122,168],[50,123,187],[89,96,90],[66,65,107],[179,89,180],[119,101,120],[68,63,104],[234,93,227],[16,15,85],[209,129,49],[15,14,86],[107,55,9],[120,100,121],[153,145,22],[178,88,179],[197,6,196],[89,88,96],[135,138,136],[138,215,172],[218,115,219],[41,42,81],[5,195,51],[57,43,61],[208,171,199],[41,81,38],[224,53,225],[24,144,110],[105,52,66],[118,229,117],[227,34,234],[66,107,69],[10,109,151],[219,48,235],[183,62,191],[142,129,126],[116,111,143],[118,117,50],[223,222,52],[94,19,141],[222,221,65],[196,3,197],[45,220,44],[156,70,139],[188,122,245],[139,71,162],[149,170,150],[122,188,196],[206,216,92],[164,2,167],[242,141,241],[0,164,37],[11,72,12],[12,38,13],[70,63,71],[31,226,111],[36,101,205],[203,206,165],[126,209,217],[98,165,97],[237,220,218],[237,239,241],[210,214,169],[140,171,32],[241,125,237],[179,86,178],[180,85,179],[181,84,180],[182,83,181],[194,201,182],[177,137,132],[184,76,183],[185,61,184],[186,57,185],[216,212,186],[192,214,187],[139,34,156],[218,79,237],[147,123,177],[45,44,4],[208,201,32],[98,64,129],[192,213,138],[235,59,219],[141,242,97],[97,2,141],[240,75,235],[229,24,228],[31,25,226],[230,23,229],[231,22,230],[232,26,231],[233,112,232],[244,189,243],[189,221,190],[222,28,221],[223,27,222],[224,29,223],[225,30,224],[113,247,225],[99,60,240],[213,147,215],[60,20,166],[192,187,213],[243,112,244],[244,233,245],[245,128,188],[188,114,174],[134,131,220],[174,217,236],[236,198,134],[215,177,58],[156,143,124],[25,110,7],[31,228,25],[264,356,368],[0,11,267],[451,452,349],[267,302,269],[350,357,277],[350,452,357],[299,333,297],[396,175,377],[280,347,330],[269,303,270],[151,9,337],[344,278,360],[424,418,431],[270,304,409],[272,310,407],[322,270,410],[449,450,347],[432,422,434],[18,313,17],[291,306,375],[259,387,260],[424,335,418],[434,364,416],[391,423,327],[301,251,298],[275,281,4],[254,373,253],[375,307,321],[280,425,411],[200,421,18],[335,321,406],[321,320,405],[314,315,17],[423,426,266],[396,377,369],[270,322,269],[413,417,464],[385,386,258],[248,456,419],[298,284,333],[168,417,8],[448,346,261],[417,413,285],[326,327,328],[277,355,329],[309,392,438],[381,382,256],[279,429,360],[365,364,379],[355,277,437],[282,443,283],[281,275,363],[395,431,369],[299,297,337],[335,273,321],[348,450,349],[359,446,467],[283,293,282],[250,458,462],[300,276,383],[292,308,325],[283,276,293],[264,372,447],[346,352,340],[354,274,19],[363,456,281],[426,436,425],[380,381,252],[267,269,393],[421,200,428],[371,266,329],[432,287,422],[290,250,328],[385,258,384],[446,265,342],[386,387,257],[422,424,430],[445,342,276],[422,273,424],[306,292,307],[352,366,345],[268,271,302],[358,423,371],[327,294,460],[331,279,294],[303,271,304],[436,432,427],[304,272,408],[395,394,431],[378,395,400],[296,334,299],[6,351,168],[376,352,411],[307,325,320],[285,295,336],[320,319,404],[329,330,349],[334,293,333],[366,323,447],[316,15,315],[331,358,279],[317,14,316],[8,285,9],[277,329,350],[253,374,252],[319,318,403],[351,6,419],[324,318,325],[397,367,365],[288,435,397],[278,344,439],[310,272,311],[248,195,281],[375,273,291],[175,396,199],[312,311,268],[276,283,445],[390,373,339],[295,282,296],[448,449,346],[356,264,454],[337,336,299],[337,338,151],[294,278,455],[308,292,415],[429,358,355],[265,340,372],[352,346,280],[295,442,282],[354,19,370],[285,441,295],[195,248,197],[457,440,274],[301,300,368],[417,351,465],[251,301,389],[394,395,379],[399,412,419],[410,436,322],[326,2,393],[354,370,461],[393,164,267],[268,302,12],[312,268,13],[298,293,301],[265,446,340],[280,330,425],[322,426,391],[420,429,437],[393,391,326],[344,440,438],[458,459,461],[364,434,394],[428,396,262],[274,354,457],[317,316,402],[316,315,403],[315,314,404],[314,313,405],[313,421,406],[323,366,361],[292,306,407],[306,291,408],[291,287,409],[287,432,410],[427,434,411],[372,264,383],[459,309,457],[366,352,401],[1,274,4],[418,421,262],[331,294,358],[435,433,367],[392,289,439],[328,462,326],[94,2,370],[289,305,455],[339,254,448],[359,255,446],[254,253,449],[253,252,450],[252,256,451],[256,341,452],[414,413,463],[286,441,414],[286,258,441],[258,257,442],[257,259,443],[259,260,444],[260,467,445],[309,459,250],[305,289,290],[305,290,460],[401,376,435],[309,250,392],[376,411,433],[453,341,464],[357,453,465],[343,357,412],[437,343,399],[344,360,440],[420,437,456],[360,420,363],[361,401,288],[265,372,353],[390,339,249],[339,448,255],[255,339,448]].flat(),$=[.5104879319667817,.33515610277652746,.5174233198165894,.43859300494194037,.5123749554157258,.406469448208809,.5423470318317414,.5244461464881898,.5190713584423066,.46557595014572145,.5194876372814179,.5006013351678849,.5178673148155213,.5855525898933411,.7009655416011811,.5918984371423721,.5193980515003205,.6528422343730926,.520683366060257,.689273599088192,.5248700261116028,.8232529717683792,.5099657952785492,.32301718473434454,.5088536620140076,.31080526888370513,.5081197202205658,.3013389307260514,.5072353065013886,.29900476515293123,.5073091566562653,.28442813932895666,.5065075337886811,.26649361431598667,.5061309516429902,.24778731942176818,.5031875848770142,.22179436564445493,.515326726436615,.4231037962436676,.5375777959823609,.4205444622039795,.8049442350864411,.6867966356873512,.6222659975290299,.570705144405365,.6496635556221009,.567776631116867,.6773027807474137,.5670208501815797,.7126377105712891,.5800703662633897,.5999099642038346,.5764724123477936,.674340370297432,.6495546865463258,.639536875486374,.6477413746714593,.703840109705925,.642201315164566,.7209078550338746,.6294069054722786,.7342745542526246,.5601695317029953,.6015644401311875,.18118685364723203,.7114282578229905,.598883952498436,.809715884923935,.5682615923881531,.7667155593633652,.5767241555452347,.6445030301809311,.45154162526130676,.541424173116684,.34213731765747074,.5359058856964112,.3113374251127243,.5710002213716507,.33134433805942537,.5891562283039093,.31890978991985325,.5585465461015702,.3096196609735489,.5759132236242295,.30601608335971836,.6229794204235077,.2713706839084626,.5398103773593903,.43802148282527925,.545369166135788,.46441581428051,.7616913348436356,.6473416510224344,.5914883643388749,.5243312466144563,.5945767045021058,.44076132655143746,.5964909076690674,.4544808346033096,.7225886166095734,.4498931097984314,.5443432211875916,.49703910827636727,.7029067009687424,.6777765545248986,.7391736537218094,.6677046212553979,.7836920201778412,.7359224516153335,.577455359697342,.6573990839719772,.6085408657789231,.6353888112306596,.6427326381206513,.298196165561676,.7550604224205018,.30743678390979773,.5732827365398407,.4262381809949875,.5523188143968583,.417594336271286,.6096987754106522,.29745593249797825,.6036115020513535,.2985246556997299,.7549919366836548,.6845966669917107,.592850747704506,.4273046988248826,.6501948565244675,.6762702855467797,.6582381755113602,.699515787065029,.682483646273613,.802994977235794,.768890205025673,.710366437137127,.6672395795583725,.752104974091053,.7775519520044327,.6584857258200645,.7920276552438736,.6709628927707671,.5397542297840119,.3256357330083847,.5643998861312867,.3199443298578262,.5826229482889176,.313130943775177,.5657853364944458,.42035281538963326,.606510478258133,.2980171996355057,.5952901721000672,.2918463486433029,.5999826073646546,.29865378022193906,.565356719493866,.4374908703565598,.570739108324051,.30172707617282873,.5532697021961213,.303354971408844,.532040822505951,.3026815611124039,.5385064661502839,.22311560392379765,.5377482950687409,.25083183526992797,.5373399734497071,.26933391273021695,.5351483404636384,.28629542768001554,.5317461371421814,.3004490631818772,.5704152762889863,.30009212374687194,.5761924862861634,.2931597578525544,.5817892730236054,.28451425909996036,.5862761169672013,.27445026516914367,.6169582635164261,.3500816184282303,.7930811375379563,.4456584650278092,.5136566936969758,.41420710563659674,.5836256474256516,.29897587478160864,.5893380820751191,.29504160165786747,.5458188831806183,.4063113230466843,.581692311167717,.41034119904041294,.5490593492984772,.4114610868692398,.6189475685358048,.5063568043708802,.6631498366594315,.48547921061515814,.5990702986717225,.44076220870018007,.7452016949653626,.7754116746783257,.729542288184166,.7380649703741073,.7152380675077439,.6996659177541733,.6012845069169999,.2532631474733353,.5908916622400284,.6924743655323982,.6002487272024155,.7558749470114707,.611236396431923,.817432113289833,.6991332352161408,.5705236423015594,.7608276635408402,.5389788854122162,.5859951555728913,.5837152945995332,.7452233761548996,.6138822454214097,.5740126550197602,.542653586268425,.5829357832670212,.45267452478408815,.7883433729410172,.5171645599603654,.7431249052286149,.5203535276651383,.7091684520244599,.5116798001527787,.6566549122333527,.5192352938652038,.6176983743906022,.532645167708397,.590181502699852,.5458893078565599,.5431278228759766,.5780327129364013,.7785866141319275,.4588600414991379,.7662802815437317,.614813904762268,.528258103132248,.42353384375572206,.5884005159139634,.49679056286811835,.8132390558719635,.5690749335289003,.5698921114206315,.5609081107378007,.5997681200504303,.4383326607942582,.7258545190095902,.5959577548503876,.5829301953315735,.4692867088317872,.7767194837331772,.37870833754539496,.5859857678413392,.5927838939428329,.5655010223388672,.4863545227050781,.7103684276342392,.24216726005077366,.7039464592933655,.21081999421119696,.7955554753541947,.45157338261604313,.7394011497497559,.27975760281085965,.8023439675569535,.6235768947005271,.6065513819456101,.1520459520816803,.5237656712532044,.4144193726778031,.6113508373498917,.4744607317447663,.7872020035982132,.5706054615974427,.6744208365678788,.5840893256664277,.6509357273578644,.5835042405128479,.599469143152237,.28584001839160916,.76683469414711,.4027401643991471,.5548133134841919,.11242247700691227,.6348527550697327,.15134210765361789,.6676738739013672,.17523885548114776,.5231557369232178,.758142014145851,.49590798020362853,.10746171355247497,.6282390981912613,.5856175380945206,.6072420954704285,.5888098138570785,.592762503027916,.5906054276227952,.7843813925981522,.61877524882555,.610203567147255,.6159668180346489,.6345708996057511,.625477318763733,.6599059730768204,.6266139122843744,.6838259130716324,.6209151762723923,.6978932946920395,.6127474161982536,.8138886868953705,.6332776087522507,.690067994594574,.587394626736641,.5115295231342316,.3814830261468887,.593753132224083,.3682318288087845,.5745513767004014,.43174642801284796,.5468618154525757,.38006519258022314,.5175330221652985,.6183956491947173,.6776301890611649,.20638245522975923,.6439310491085053,.1795444029569626,.5587406486272812,.13319884419441225,.7303948730230332,.25156523168087,.5936179041862488,.6020026791095734,.5595558166503907,.5354639637470247,.49903409481048583,.12705478847026824,.5986292988061905,.12926876127719883,.7810411036014557,.3901792484521866,.5526776045560837,.3004089254140854,.5582781463861466,.2904709684848786,.5625745087862015,.2769930589199066,.5656344175338746,.26021293580532073,.5736826092004776,.23544175803661344,.5897697389125824,.3026730704307556,.5960018962621689,.3050022739171982,.6013990819454194,.30801084220409397,.6334722220897675,.32613734483718876,.7345953911542893,.3890004771947861,.5586504369974137,.5622388321161271,.5686756849288941,.6147718372941018,.5835970371961594,.6114995065331459,.58382708132267,.30018893957138065,.7323651343584061,.3204736191034317,.5478970587253571,.6144195291399956,.5885591685771943,.20925473153591162,.5188342511653901,.5294416445493699,.5430448532104493,.5502454686164857,.5189176678657532,.5563708889484407,.5749752998352051,.4918947476148606,.5015926539897919,.1563655036687851,.5023517191410065,.19124654710292815,.5467969954013825,.1949619370698929,.6493796885013581,.2596786844730377,.6223085105419159,.4147812741994858,.6219283074140549,.2305004018545151,.6836527764797211,.41583852946758276,.6457133769989014,.38482945740222935,.7015091359615326,.3687519657611847,.5560723870992661,.1615346747636795,.5877480685710907,.4753766226768494,.672212439775467,.23758670270442966,.6372418433427811,.20715841531753537,.6714329898357392,.2934120523929596,.7559577107429505,.3546825754642487,.7028004407882691,.28965476036071774,.7641248583793641,.3323610144853592,.6633666038513184,.34586538851261145,.5732450067996979,.5168171036243439,.5740206122398377,.4420601803064346,.5862565368413926,.4328912365436554,.5658091634511948,.46056721985340127,.5935333251953125,.6414948242902756,.643502163887024,.6581727835536004,.6862205892801285,.6599488797783852,.71900634765625,.6517863023281099,.7387710094451905,.6366994085907935,.7436862468719483,.5870225805044174,.8067718029022217,.5102852332592012,.719052392244339,.549573050737381,.6912373930215836,.5426725524663925,.6540380597114563,.5452089506387712,.6191460520029068,.5529706466197968,.5933077514171601,.5624450343847276,.5760908752679825,.5711276936531067,.8037864595651627,.5079354095458986,.5832139283418656,.42433229863643646,.5602819353342057,.5111040878295898,.5571386992931366,.44193623840808877,.5406022548675538,.42711933732032775,.5550468444824219,.43675835609436037,.5743813246488572,.4152073520421982,.5367868125438691,.42474128484725954,.5321040332317353,.41727378547191624,.5769275009632111,.5919214832782747,.5631695121526719,.5864408034086228,.555830317735672,.5819090950489045,.7057080000638962,.6055842030048371,.7297580271959305,.614007951617241,.49450652599334716,.5258826154470444,.30584611296653746,.6040364730358123,.4885244846343994,.4224347966909409,.188004332780838,.7111089858412742,.3873521864414215,.5786778944730759,.3588928759098053,.5761974024772645,.32972376346588134,.5772378969192504,.29263614416122435,.5937507289648056,.4124107241630554,.5837435233592987,.3437161326408386,.6627882960438729,.3795058310031891,.6574259343743325,.3114838480949402,.657741964161396,.2904722273349762,.6461278694868089,.2668101370334625,.5759735572338105,.3916287899017334,.18396661460399627,.2956514835357666,.6133467811346054,.17441000342369078,.5913206297159195,.23045413494110106,.5952582108974458,.3695909559726715,.4586390632390976,.4777859032154083,.34189285218715665,.4799880862236023,.31095413148403167,.4436598002910614,.32987600147724155,.42009713053703307,.3173161882162094,.4536511182785034,.3079365211725235,.431768137216568,.30468503117561346,.37606616616249083,.27423435926437384,.49449856877326964,.4396295297145844,.4917183697223663,.4654612708091736,.2524005055427551,.6652582022547722,.4289156973361969,.5291139262914657,.4268526315689087,.44427823305130004,.42474048137664794,.45817836105823523,.2809027314186096,.46354105353355407,.49383275508880614,.49885324716567997,.3271153151988983,.6924127805233002,.28349151015281676,.6843035730719567,.22369228601455687,.7584647151827812,.4591939032077789,.6617383736371993,.40913431644439696,.6426751393079757,.35715471506118773,.30240225076675414,.1987894058227539,.3237072455883026,.4482724845409393,.42876928627491,.4697932779788971,.4196605491638184,.39104996919631957,.2959751355648041,.3971476137638092,.29665681600570676,.26748310327529906,.7016683402657509,.4251814365386963,.4304117369651795,.3845069885253906,.6860294970870018,.3804918110370636,.7099798905849457,.35481985211372374,.8164000543951988,.2475942552089691,.730037857890129,.37163846492767333,.7639490339159964,.23443256616592406,.677293357551098,.2116762578487396,.6924480664730073,.4783883273601532,.32515374898910526,.44883744716644286,.3184075164794922,.42566208839416503,.31092865943908693,.45405327081680297,.4228447753190994,.3932682454586029,.2964416819810867,.4071350872516632,.290535255074501,.40034677386283873,.29673135757446295,.4610676050186157,.44076672971248626,.4361940503120422,.3005809444189072,.45694692730903624,.30211268544197084,.4812539994716644,.30183855772018436,.46574126482009887,.22492808878421783,.47153966426849364,.25130698263645174,.4740802526473999,.2694691020250321,.4768980026245117,.28705804526805884,.48090897798538207,.2996276724338532,.43501039147377013,.2992805469036102,.4293511092662811,.2932880002260208,.4233271360397339,.28415390133857726,.41761367321014403,.27479386210441586,.39445154666900634,.3538810330629349,.16652100086212157,.4672100204229355,.4183532476425171,.29779809594154355,.41378535628318786,.29400077641010286,.47695048451423644,.40816306352615356,.43489335775375365,.41207451105117804,.473628032207489,.41300628066062933,.3975309908390045,.5133917200565339,.34924407601356505,.4949547010660172,.4189921498298645,.44448454558849343,.27738903760910033,.7946441161632538,.29866914749145507,.7549788492918015,.3170970857143402,.7143296006321906,.39919986128807067,.2556870716810226,.4517517566680908,.6986333075165749,.44375439286231994,.7623249980807305,.4346091330051422,.8250303360819817,.3058603286743164,.5830274391174317,.235262531042099,.5560186910629272,.4279192566871643,.5892863947153091,.2622906148433685,.6309370476007461,.45053591132164,.5464099961519242,.44443781971931456,.45605955004692084,.20207332372665404,.5370177584886551,.25663607120513915,.5358516681194305,.29581143260002135,.5243526387214661,.3525206625461578,.5284005987644196,.39442025423049926,.5392975616455078,.42579718232154845,.5511161494255066,.49076547026634215,.5801296907663345,.20957841277122496,.47626241028308874,.23929433822631835,.6331100556254388,.5024659812450409,.4247821944952011,.432133811712265,.5009672063589097,.15906893014907836,.5940177994966507,.4492078602313995,.5648097443580629,.41579030752182006,.4419312763214112,.2798506796360016,.6113770532608032,.44294874668121337,.47275686144828805,.1783646523952484,.3979667472839356,.42730753421783446,.5981915760040284,.46777849197387694,.4889896112680436,.26486464142799376,.2499848622083664,.26026474237442015,.21801546096801755,.17761032581329345,.47220298230648045,.23215438723564147,.29172880232334136,.1906857371330261,.6463678139448166,.3811529755592346,.1541750180721283,.5033367156982422,.41569132089614874,.40528597235679625,.4797393995523453,.2049500823020935,.59123428940773,.3344294309616089,.5942869651317597,.35825960636138915,.5929379391670226,.4015964150428772,.28595646202564245,.21618961095809935,.4194869863986969,.43316020369529723,.11274379968643189,.34098224639892577,.1526068884134293,.3026312172412872,.17882644414901733,.3831480026245117,.5945327538251877,.40483357310295104,.5966399866342544,.419615763425827,.5973996269702913,.2160478115081787,.6388220790028571,.40051244497299193,.6220169800519944,.37555851340293883,.6336345481872558,.3499592423439026,.6373451414704323,.32648445963859557,.6342222797870636,.3108482539653778,.6266552078723908,.16784127354621886,.6591027337312698,.3177972316741943,.5982361245155334,.4220952868461609,.3706905978918075,.4483287215232849,.43451813936233524,.4753179132938385,.38104525983333587,.30160035490989684,.21209139108657843,.33879016637802123,.18215490162372588,.4353105306625366,.1335425513982773,.22725783586502074,.2627154815196991,.4187734603881836,.6076370733976364,.471796441078186,.5377814787626267,.3835057199001312,.13003402531147007,.18837626576423644,.4081169712543488,.4558822691440582,.3006539422273636,.45070006251335143,.29020555198192594,.44506027102470397,.276558490395546,.441160249710083,.26132532536983494,.42807196378707885,.237567846775055,.413764613866806,.300301303267479,.40849854350090026,.3033808845281601,.40325652360916137,.3060078132152558,.3719393193721771,.3296157675981522,.2585947096347809,.4027331072092057,.4712364852428436,.5652889716625213,.4525624096393585,.6187475714087487,.43274884223937987,.6166740807890891,.4197424530982971,.2985221195220948,.25107048749923705,.3324888157844544,.48253663182258605,.6165598976612092,.40862621665000914,.21186126053333282,.4922338902950287,.5517929780483246,.4509614884853363,.49562425196170806,.45456190705299376,.19553345918655402,.3438455045223236,.2646773803234101,.39053775668144225,.41997271955013277,.3724295377731323,.2345973211526871,.32362549304962157,.42551548063755035,.3627460479736328,.39166522800922393,.2982912242412567,.37974442124366764,.44216259121894835,.16258520364761353,.4327280104160309,.47912641644477844,.31535937190055846,.24389803588390352,.35182328820228576,.2114975947141648,.3249718725681305,.3009969878196716,.22358919978141784,.36996547162532806,.2854694604873657,.29810287833213805,.2033691883087158,.34796677708625795,.3403308272361755,.35305335700511936,.4522935628890991,.520306442975998,.45397244691848754,.4453733104467393,.4360526978969574,.4358169931173325,.4670851409435272,.463337938785553,.430365788936615,.6462299782037735,.3818374752998352,.6678127396106721,.3376319885253906,.6731280717253685,.3007634162902832,.6677066612243652,.2756028652191162,.6542664083838463,.25909878611564635,.6035455572605133,.17238967418670653,.5322284626960754,.28373541235923766,.5632325726747514,.3148886442184448,.5544471430778504,.35481600761413573,.554238184094429,.39195387363433837,.5604119020700455,.4199950277805328,.5684955823421478,.4408359706401825,.5755523312091828,.1607656955718994,.5315613377094268,.43638269901275634,.4271241891384125,.4722903251647949,.513996543288231,.4744726598262787,.4443250972032547,.48785080313682555,.4292660462856293,.4740713119506836,.43900651216506964,.443528014421463,.4168834346532822,.49345849752426146,.4267724323272705,.49457465410232543,.4177086848020554,.438745903968811,.5969951617717744,.4560649275779724,.5900395292043685,.4670982837677002,.5844003933668136,.3021982192993164,.6197374525666237,.27794389724731444,.6304952013492584,.6290517628192902,.6082503873109817,.601810845732689,.608769752383232,.6309714198112488,.6319623801112175,.657788547873497,.6077486652135848,.6277183473110199,.5834045577049256,.333698707818985,.6181534442305565,.3082489252090454,.6187389704585076,.3358501076698303,.6419334176182747,.3613401234149933,.618020570576191,.33353258967399596,.5936576622724534],P=468,e0=P*3,t0={type:"standard",color:"#ffffff",opacity:1,wireframe:!1,roughness:1,metalness:0},D=({material:e,faceIndex:t=0,numFaces:n,visible:r=!0,children:o})=>{const{ready:u,node:d}=N(S.XRModel.FACE_TRACKER,n===void 0?void 0:{numFaces:n}),{camera:l}=v.useThree(),c=s.useRef(null),h=s.useRef(null),p=s.useRef(null),f=s.useRef(null),i=s.useRef(null),A=s.useRef(new b.Vector3),E=s.useMemo(()=>{const M=new Uint16Array(Q),R=new b.BufferAttribute(M,1),y=new b.Float32BufferAttribute($,2),C=new Float32Array(e0),a=new b.Float32BufferAttribute(C,3);return a.setUsage(b.DynamicDrawUsage),{indexAttr:R,uvAttr:y,positionAttr:a,positions:C}},[]);s.useEffect(()=>{f.current=E.indexAttr,i.current=E.uvAttr,p.current=E.positionAttr,h.current=E.positions;const M=c.current;if(M){const R=M.geometry;R.setAttribute("position",E.positionAttr),R.setAttribute("uv",E.uvAttr),R.setIndex(E.indexAttr)}return()=>{f.current=null,i.current=null,p.current=null,h.current=null}},[E]),v.useFrame(()=>{var m;if(!u||!d||!c.current)return;const{detectionResults:M}=d,R=(m=M==null?void 0:M.faceLandmarks)==null?void 0:m[t],y=c.current.geometry,C=h.current,a=p.current;if(!R||R.length===0||!C||!a){y.drawRange.count!==0&&y.setDrawRange(0,0);return}y.getAttribute("position")!==a&&(y.setAttribute("position",a),y.setAttribute("uv",i.current),y.setIndex(f.current)),y.drawRange.count===0&&y.setDrawRange(0,1/0),J(R,P,C,l,W,A.current),a.needsUpdate=!0,y.computeVertexNormals()});const F=o!=null&&o!==!1;return _.jsxs("mesh",{material:e,ref:c,visible:r,children:[_.jsx("bufferGeometry",{}),!e&&!F&&_.jsx(U,{settings:t0,materialProps:{attach:"material",transparent:!0,depthWrite:!1,side:b.DoubleSide,needsUpdate:!0}}),!e&&F?o:null]})};D.displayName="FaceMesh";const L={"face.forehead":10,"face.noseTip":1,"face.chin":152,"face.leftEyeOuter":263,"face.rightEyeOuter":33,"face.leftCheek":425,"face.rightCheek":205,"face.mouthCenter":13,"face.leftEarlobe":454,"face.rightEarlobe":234},r0={"face.center":[10,152,234,454],"face.leftEye":[263,362,387,373],"face.rightEye":[33,133,158,145]},K=(e,t=0)=>Number.isFinite(e)?e:t,w=e=>Math.max(-1,Math.min(1,K(e))),n0={x:0,y:0,z:0},H=(e,t,n=n0,r={x:0,y:0,z:0,visibility:0})=>{const o=L[e];if(o!==void 0){const i=t[o];return i?Object.assign(r,i):null}const u=r0[e];if(u){r.x=0,r.y=0,r.z=0;for(const i of u){const A=t[i];if(!A)return null;r.x+=A.x,r.y+=A.y,r.z+=A.z}return r.x/=u.length,r.y/=u.length,r.z/=u.length,r.visibility=1,r}if(e!=="face.custom"||t.length===0)return null;let d=1/0,l=1/0,c=-1/0,h=-1/0,p=0;for(const i of t)d=Math.min(d,i.x),l=Math.min(l,i.y),c=Math.max(c,i.x),h=Math.max(h,i.y),p+=i.z;const f=c-d;return r.x=(d+c)*.5-w(n.x)*f*.5,r.y=(l+h)*.5-w(n.y)*(h-l)*.5,r.z=p/t.length-K(n.z)*f,r.visibility=1,r},s0={left:L["face.leftEyeOuter"],right:L["face.rightEyeOuter"]},O=s.createContext(null),o0=()=>s.useContext(O),c0=({faceIndex:e=0,numFaces:t,scaleWithFace:n=!1,followFaceRoll:r=!0,targetFps:o,active:u=!0,children:d})=>{const l=s.useRef(!1),c=s.useRef(null),h=s.useMemo(()=>{if(!(t===void 0&&o===void 0))return{...t===void 0?{}:{numFaces:t},...o===void 0?{}:{targetFps:o}}},[t,o]),{ready:p,node:f}=N(S.XRModel.FACE_TRACKER,h,u),{camera:i}=v.useThree(),A=s.useRef(i);A.current!==i&&(A.current=i,l.current=!1);const E=s.useRef(null),F=s.useRef({x:0,y:0,z:0,visibility:0});v.useFrame(()=>{if(!p||!f||!c.current)return;E.current=f,!l.current&&A.current&&(f.setCamera(A.current,e),l.current=!0);const a=f.getFace(e);if(!a){c.current.visible=!1;return}c.current.visible=!0;const{position:m,rotation:x,scale:T}=a.transform;c.current.position.set(m.x,m.y,m.z),c.current.rotation.set(x.x,x.y,r?x.z:0),n?c.current.scale.set(T.x,T.y,T.z):c.current.scale.set(1,1,1)});const M=s.useCallback((a,m)=>{var I,k;const x=E.current,T=(k=(I=x==null?void 0:x.detectionResults)==null?void 0:I.faceLandmarks)==null?void 0:k[e];if(!T||T.length===0)return null;const g=H(a,T,m,F.current);return g?{position:S.unprojectToZZero(g,A.current)}:null},[e]),R=s.useMemo(()=>({type:"face",resolveLandmark:M}),[M]);let y;const C=[];return s.Children.forEach(d,a=>{var m,x;s.isValidElement(a)&&(((m=a.type)==null?void 0:m.displayName)==="FaceTracker.Mesh"||((x=a.type)==null?void 0:x.displayName)==="FaceMesh")?y=s.cloneElement(a,{faceIndex:e,numFaces:t}):C.push(a)}),_.jsxs(O.Provider,{value:R,children:[_.jsx("group",{ref:c,renderOrder:X.RENDER_LAYERS.TRACKED,children:C}),y]})},q=e=>_.jsx(D,{...e});q.displayName="FaceTracker.Mesh";const z=c0;z.Mesh=q;const i0=z;exports.FACE_EYE_DISTANCE_LANDMARKS=s0;exports.FACE_LANDMARK_INDICES=L;exports.FaceMesh=D;exports.FaceTracker=z;exports.HeadTracker=i0;exports.MeshMaterial=U;exports.TrackerContext=O;exports.projectLandmarkWithDepth=G;exports.resolveFaceAnchorPoint=H;exports.transformFaceMeshLandmark=B;exports.useTrackerContext=o0;exports.useXRModel=N;