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

package/README.md

@@ -1,85 +1,119 @@
-# RTX AR Tracking SDK
+# Vincentt XR SDK
 
-This SDK is intended for implementing AI-powered tracking for WebAR projects by rangoon.tech.
+`@vincentt-xr/sdk` is the AR runtime for Vincentt projects. It gives a React +
+react-three-fiber app a camera session, face/hand/body tracking, and the
+screen-space layout primitives that most AR effects are built from.
 
-## Installation
-First, install the library by running the command
+Your JSX renders directly — in local preview and in the published bundle at
+`<slug>.vincentt.app`.
+
+## Install
+
+The SDK is installed for you when you scaffold a project from the Vincentt
+template, which pins a known-good version alongside its peers:
 
 ```
-npm install @rangoon/track
+vincentt create my-app
 ```
 
-If you're using yarn,
+To add it to an existing project:
 
 ```
-yarn add @rangoon/track
+pnpm add @vincentt-xr/sdk
 ```
 
-## How to use
-The usage of `@rangoon/track` usually involves two steps.
+It expects `react`, `react-dom`, `three`, `@react-three/fiber`,
+`@react-three/drei`, and `@mediapipe/tasks-vision` as peers. The template
+already pins compatible versions of all of them; mismatched copies of React or
+three.js are the most common source of runtime errors.
 
-### 1. Start a video stream
-Initialize the SDK by attaching the `@rangoon/track`'s `Webcam` component to your React Project. 
-The `Webcam` component will start a video stream which will be used for tracking. 
+## Quick start
 
-```ts
-import { Webcam } from "@rangoon/track"
-import { useRef } from "react"
+Wrap your app in `XRProvider`, mount an `XRScene`, and add content. Trackers
+self-register when mounted — there is no pipeline to wire up by hand.
 
-function App() {
+```tsx
+import { ScreenSpaceUI, ScreenText, XRProvider, XRScene } from "@vincentt-xr/sdk";
+import { useFaceDetection } from "@vincentt-xr/sdk/tracking";
 
-  const videoRef = useRef<HTMLVideoElement>(null)
+function Effect() {
+  const detection = useFaceDetection({ numFaces: 1 });
+
+  if (detection.face) return null;
 
   return (
-    <div>
-      <Webcam videoReference={videoRef}/>
-    </div>
-  )
+    <ScreenSpaceUI>
+      <ScreenText
+        text="SHOW A FACE TO THE CAMERA"
+        screenTransform={{ position: { x: 0, y: 0 }, size: { width: 400, height: 52 } }}
+        fontSize={24}
+      />
+    </ScreenSpaceUI>
+  );
 }
 
-export default App
-
+export default function App() {
+  return (
+    <XRProvider>
+      <XRScene>
+        <Effect />
+      </XRScene>
+    </XRProvider>
+  );
+}
 ```
 
-### 2. Initiate a tracking model
+## Import doors
 
-Currently, `@rangoon/track` supports three types of tracking models.
-* Hand Tracking (Landmarks)
-* Hand Gesture Tracking (Landmarks + Gestures)
-* Face Tracking
+The API is split by task domain. Import each symbol from the door that owns it.
 
-By calling the Hook associated with the respective model, you can obtain the tracking data.
+| Entry point                      | What lives there                                                                |
+| -------------------------------- | ------------------------------------------------------------------------------- |
+| `@vincentt-xr/sdk`               | Providers, scene root, screen-space layout, renderers, text, capture, audio       |
+| `@vincentt-xr/sdk/tracking`      | Face / hand / gesture / body / segmentation trackers, anchors, triggers            |
+| `@vincentt-xr/sdk/instructions`  | Gesture / expression / pose prompts with a 3D hint, their detectors and hint kit   |
+| `@vincentt-xr/sdk/face-effects`  | Face mesh materials, retouch, canonical mesh, head binding                        |
+| `@vincentt-xr/sdk/scene-object`  | Scene-object types, factories, selectors, immutable store operations              |
+| `@vincentt-xr/sdk/low-level`     | Raw model-node reads and custom-tracker plumbing — the escape hatch               |
+| `@vincentt-xr/sdk/debug-ui`      | Dev-only inspector panels; not for shipping surfaces                              |
 
-Below is an example of obtaining hand-tracking data with `useHandTracking` Hook.
-```ts
-import { Webcam, useHandTracking } from "@rangoon/track"
-import { useEffect, useRef } from "react"
+## Documentation
 
-function App() {
+**[`GROUNDING.md`](./GROUNDING.md) is the authoritative API reference** — every
+component, hook, and prop, plus the composition conventions. Read it before
+reaching into `node_modules` or inventing props. It ships inside the package, so
+it travels with the version you actually installed.
 
-  const videoRef = useRef<HTMLVideoElement>(null)
+Longer-form guides live in [`docs/`](./docs):
 
-  //Initiate the model by passing the webcam reference
-  const handData = useHandTracking({
-    videoReference: videoRef
-  })
+- [`docs/introduction.mdx`](./docs/introduction.mdx) — the scene-object authoring model
+- [`docs/guides/`](./docs/guides) — task guides
+- [`docs/api/`](./docs/api) — API pages
+- [`docs/MIGRATION_GUIDE.md`](./docs/MIGRATION_GUIDE.md) — upgrading from 1.x
 
-  //Watch the data changes with useEffect
-  useEffect(() => {
-    console.log(handData)
-  }, [handData])
+## Local development
 
-  return (
-    <div>
-      <Webcam videoReference={videoRef}/>
-    </div>
-  )
-}
-
-export default App
 ```
+pnpm install
+pnpm dev            # example app
+pnpm preview:tunnel # example app, reachable on a phone
+pnpm build
+pnpm test
+pnpm typecheck
+```
+
+The example app under `example/` is the development surface for the SDK itself.
+Experiments start there; once one becomes a real app it graduates to its own
+repo built against the packaged SDK.
+
+Release steps are in [`RELEASING.md`](./RELEASING.md).
+
+## License
 
+Proprietary. See [`LICENSE`](./LICENSE) — the published package is for use with
+the Vincentt platform only.
 
 ## Feedback
 
-If you have any feedback, please reach out to us at waing@rangoon.tech
+Report friction and bugs to the Vincentt team through the beta reporting flow,
+or open an issue on this repository.

package/dist/CanonicalHeadFrame-D_0OzdB9.cjs

@@ -0,0 +1 @@
+"use strict";const T=require("react/jsx-runtime"),I=require("react"),q=require("@react-three/fiber"),M=require("three"),l=require("./index-Sho4F4it.cjs"),w=require("./index-S3gqudT6.cjs"),G=require("./selectors-QB2qsaxy.cjs"),b=require("./similarityFit-BFqHND2e.cjs"),F=require("./useLandmarkPoseFit-Bg-h9BPb.cjs");function h(t){const n=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(t){for(const e in t)if(e!=="default"){const a=Object.getOwnPropertyDescriptor(t,e);Object.defineProperty(n,e,a.get?a:{enumerable:!0,get:()=>t[e]})}}return n.default=t,Object.freeze(n)}const C=h(M),k=Float32Array.from([0,-3.4064,5.97951,0,-1.12686,7.4756,0,-2.08902,6.05827,-.46393,.95536,6.63358,0,-.46317,7.58658,0,.36567,7.24287,0,2.47326,5.78863,-4.25308,2.57765,3.2797,0,4.01904,5.28476,0,4.88598,5.38526,0,8.26178,4.48153,0,-3.70681,5.86492,0,-3.9183,5.56943,0,-3.99444,5.21948,0,-4.5424,5.40475,0,-4.74558,5.52946,0,-5.01957,5.60145,0,-5.36512,5.53544,0,-6.14962,5.07137,0,-1.50109,7.1122,-.41611,-1.46645,6.44766,-7.08796,5.4348,.09962,-2.62864,2.0359,3.84812,-3.19836,1.98582,3.79695,-3.77515,2.0394,3.64619,-4.46582,2.42295,3.15517,-2.16429,2.18987,3.85182,-3.20823,3.22393,4.11582,-2.6738,3.20534,4.0922,-3.74519,3.16529,3.97241,-4.16102,3.05907,3.71955,-5.06201,1.93442,2.77609,-2.26666,-7.42577,4.38981,-4.44586,2.66399,3.17342,-7.21453,2.26301,.07315,-5.79979,2.34955,2.20406,-2.84494,-.72087,4.43313,-.71145,-3.32935,5.87704,-.60603,-3.92456,5.44492,-1.43161,-3.50095,5.49619,-1.91491,-3.80315,5.02893,-1.13104,-3.97394,5.18965,-1.56355,-4.08276,4.84226,-2.65011,-5.00365,4.18848,-.42705,-1.09413,7.36053,-.4964,-.47566,7.44036,-5.25331,3.88158,3.36316,-1.7187,.97461,4.55836,-1.60863,-.94252,5.81419,-1.65127,-.61087,5.58132,-4.7655,-.70155,3.53463,-.47831,.29577,7.10101,-3.73496,4.50823,4.55045,-4.5886,4.30204,4.04848,-6.27933,6.61543,1.42585,-1.22094,4.14217,5.10603,-2.19349,3.10032,4.00058,-3.10264,-4.35298,4.09591,-6.71968,-4.78864,-1.7454,-1.19382,-1.30679,5.73775,-.72977,-1.59371,5.83321,-2.45621,-4.34262,4.28388,-2.20482,-4.30451,4.1625,-4.98589,4.80246,3.75198,-1.59229,-1.25771,5.45695,-2.64455,4.52465,4.92156,-2.76029,5.10097,5.01599,-3.52396,8.00598,3.72916,-5.59976,5.71547,2.72426,-3.06393,6.56614,4.52998,-5.72097,4.25458,2.83085,-6.37439,4.78559,1.59169,-.67273,-3.68802,5.7378,-1.26256,-3.78769,5.41778,-1.73255,-3.95277,5.00058,-1.04362,-1.46497,5.66246,-2.32123,-4.32907,4.25816,-2.05685,-4.47767,4.52088,-2.15308,-4.27632,4.03809,-.94687,-1.03525,6.51227,-1.46913,-4.03635,4.60491,-1.02434,-3.98985,4.92669,-.53342,-3.99322,5.1382,-.76972,-6.09539,4.98588,-.69961,-5.29185,5.4483,-.66969,-4.94977,5.50961,-.63095,-4.6951,5.44937,-.58322,-4.51798,5.33987,-1.53717,-4.42321,4.74547,-1.6156,-4.47594,4.81363,-1.72905,-4.61868,4.85446,-1.83862,-4.82875,4.82374,-2.36825,-3.10624,4.8681,-7.54224,-1.04928,-2.43132,0,-1.724,6.60139,-1.82661,-4.39953,4.39902,-1.92956,-4.41183,4.49705,-.59744,-2.01369,5.86646,-1.40563,-1.7142,5.24109,-.66245,-1.81932,5.86376,-2.34234,.57222,4.2943,-3.32732,.10486,4.11386,-1.72617,-.91916,5.27336,-5.1332,7.4856,2.66044,-4.53864,6.31991,3.68342,-3.98656,5.10949,4.46631,-2.16968,-5.44043,4.45587,-1.39563,5.01196,5.31603,-1.6195,6.59922,4.92111,-1.8914,8.23638,4.275,-4.19583,2.23521,3.3751,-5.73334,1.41174,2.43173,-1.85989,2.35576,3.84318,-4.98861,3.07465,3.08386,-1.30326,1.41645,4.83109,-1.30576,-.67278,6.41596,-6.46517,.93712,1.68987,-5.25866,.94581,2.97431,-4.43234,.7221,3.52261,-3.30068,.86164,3.87278,-2.43018,1.13149,4.03903,-1.82073,1.46795,4.22412,-.56322,2.30769,5.56679,-6.33814,-.52928,1.88118,-5.5877,3.20807,2.68784,-.24262,-1.46286,7.07149,-1.61125,.33933,4.89542,-7.74309,2.365,-2.00517,-1.39114,1.85105,4.449,-1.78579,-.97828,4.85047,-4.67096,2.66446,3.08407,-1.33397,-.28376,6.09705,-7.2709,-2.89092,-2.25245,-1.85643,2.58525,3.7579,-.92339,.07308,6.67194,-5.00059,-6.13513,1.89252,-5.08528,-7.17859,.71471,-7.15929,-.81182,-.07204,-5.84305,-5.24802,.92409,-6.84726,3.66292,.72469,-2.41294,-8.25885,4.11921,-.17991,-1.68986,6.5733,-2.10366,-.16395,4.56612,-6.40757,2.23602,1.56084,-3.67007,2.36015,3.63523,-3.17719,2.29427,3.7757,-2.19612,-4.59832,4.47979,-6.23488,-1.94443,1.66354,-1.29292,-9.29592,4.09406,-3.21065,-8.53328,2.802,-4.06893,-7.99311,1.92512,0,6.54539,5.02731,0,-9.40338,4.26449,-2.72403,2.3158,3.77715,-2.28846,2.39889,3.6976,-1.99831,2.49655,3.68915,-6.13004,3.39926,2.03852,-2.28846,2.8865,3.77503,-2.72403,2.96181,3.87177,-3.17719,2.96414,3.87697,-3.67007,2.92771,3.72432,-4.01839,2.85736,3.48298,-7.55581,4.10681,-.99192,-4.01839,2.4837,3.4409,0,-2.52194,5.93226,-1.77622,-2.68395,5.21312,-1.22224,-1.18244,5.95247,-.73149,-2.53668,5.81534,0,3.27103,5.23601,-4.13527,-6.99664,2.67197,-3.31181,-7.66081,3.38296,-1.3137,-8.63999,4.70246,-5.94052,-6.22363,-.63147,-1.99831,2.74384,3.74403,-.90145,1.23699,5.75426,0,-8.76524,4.89144,-2.30898,-8.9742,3.60907,-6.95415,-2.43984,-.13116,-1.09882,-4.45879,5.12073,-1.18112,-4.58,5.18956,-1.25582,-4.7879,5.23705,-1.32509,-5.10651,5.20501,-1.54639,-5.81939,4.75789,-1.95375,-4.18389,4.43171,-2.1178,-4.13709,4.5551,-2.28534,-4.0512,4.58244,-2.85016,-3.66572,4.48499,-5.27854,-2.23894,2.86122,-.94671,1.90763,5.19678,-1.31417,3.10491,4.2314,-1.78,2.86,3.88155,-1.84511,-4.09888,4.24726,-5.43619,-4.03048,2.10985,-.76644,3.18213,4.86145,-1.93862,-6.61441,4.52109,0,1.05941,6.7746,-.51657,1.58357,6.14836,0,1.72837,6.31675,-1.24681,.2303,5.68104,0,-7.94219,5.18117,0,-6.9915,5.15348,-.99783,-6.93092,4.97958,-3.28881,-5.38251,3.79575,-2.31163,-1.56624,4.59009,-2.68025,-6.11157,4.09615,-3.83293,-1.53733,4.13773,-2.96186,-2.27421,4.44094,-4.3869,-2.68329,3.64389,-1.2173,-7.83446,4.96929,-1.54237,-.13684,5.20101,-3.87838,-6.04176,3.31108,-3.08404,-6.80984,3.8142,-3.74732,-4.50354,3.72645,-6.09413,-3.20599,1.47348,-4.58899,-4.72873,2.98322,-6.58323,-3.94127,.07027,-3.49258,-3.19582,4.1302,-1.25554,.80234,5.30755,-1.12612,-.9336,6.53878,-1.44311,-1.14277,5.90513,-.92304,-.52904,7.00342,-1.75539,3.52912,4.3277,-2.63259,3.71383,4.36463,-3.38806,3.72198,4.30903,-4.07577,3.67541,4.07606,-4.62291,3.47469,3.64632,-5.17175,2.53575,2.67087,-7.29733,.76317,-.04877,-4.70683,1.651,3.10953,-4.07171,1.47682,3.47694,-3.26982,1.47066,3.73195,-2.52757,1.61731,3.86544,-1.97089,1.85851,3.96178,-1.57954,2.09794,4.085,-7.66418,.67313,-2.43587,-1.39704,-1.34014,5.63038,-.88484,.65874,6.23323,-.7671,-.96803,7.07793,-.46021,-1.33411,6.78745,-.74862,-1.06799,6.7983,-1.23641,-1.58557,5.48049,-.38731,-1.40999,6.95771,-.31993,-1.60793,6.50868,-1.63963,2.5563,3.86374,-1.25565,2.46714,4.2038,-1.03136,2.38266,4.61585,-4.25308,2.7723,3.3153,-4.53,2.91,3.33968,.46393,.95536,6.63358,4.25308,2.57765,3.2797,.41611,-1.46645,6.44766,7.08796,5.4348,.09962,2.62864,2.0359,3.84812,3.19836,1.98582,3.79695,3.77515,2.0394,3.64619,4.46582,2.42295,3.15517,2.16429,2.18987,3.85182,3.20823,3.22393,4.11582,2.6738,3.20534,4.0922,3.74519,3.16529,3.97241,4.16102,3.05907,3.71955,5.06201,1.93442,2.77609,2.26666,-7.42577,4.38981,4.44586,2.66399,3.17342,7.21453,2.26301,.07315,5.79979,2.34955,2.20406,2.84494,-.72087,4.43313,.71145,-3.32935,5.87704,.60603,-3.92456,5.44492,1.43161,-3.50095,5.49619,1.91491,-3.80315,5.02893,1.13104,-3.97394,5.18965,1.56355,-4.08276,4.84226,2.65011,-5.00365,4.18848,.42705,-1.09413,7.36053,.4964,-.47566,7.44036,5.25331,3.88158,3.36316,1.7187,.97461,4.55836,1.60863,-.94252,5.81419,1.65127,-.61087,5.58132,4.7655,-.70155,3.53463,.47831,.29577,7.10101,3.73496,4.50823,4.55045,4.5886,4.30204,4.04848,6.27933,6.61543,1.42585,1.22094,4.14217,5.10603,2.19349,3.10032,4.00058,3.10264,-4.35298,4.09591,6.71968,-4.78864,-1.7454,1.19382,-1.30679,5.73775,.72977,-1.59371,5.83321,2.45621,-4.34262,4.28388,2.20482,-4.30451,4.1625,4.98589,4.80246,3.75198,1.59229,-1.25771,5.45695,2.64455,4.52465,4.92156,2.76029,5.10097,5.01599,3.52396,8.00598,3.72916,5.59976,5.71547,2.72426,3.06393,6.56614,4.52998,5.72097,4.25458,2.83085,6.37439,4.78559,1.59169,.67273,-3.68802,5.7378,1.26256,-3.78769,5.41778,1.73255,-3.95277,5.00058,1.04362,-1.46497,5.66246,2.32123,-4.32907,4.25816,2.05685,-4.47767,4.52088,2.15308,-4.27632,4.03809,.94687,-1.03525,6.51227,1.46913,-4.03635,4.60491,1.02434,-3.98985,4.92669,.53342,-3.99322,5.1382,.76972,-6.09539,4.98588,.69961,-5.29185,5.4483,.66969,-4.94977,5.50961,.63095,-4.6951,5.44937,.58322,-4.51798,5.33987,1.53717,-4.42321,4.74547,1.6156,-4.47594,4.81363,1.72905,-4.61868,4.85446,1.83862,-4.82875,4.82374,2.36825,-3.10624,4.8681,7.54224,-1.04928,-2.43132,1.82661,-4.39953,4.39902,1.92956,-4.41183,4.49705,.59744,-2.01369,5.86646,1.40563,-1.7142,5.24109,.66245,-1.81932,5.86376,2.34234,.57222,4.2943,3.32732,.10486,4.11386,1.72617,-.91916,5.27336,5.1332,7.4856,2.66044,4.53864,6.31991,3.68342,3.98656,5.10949,4.46631,2.16968,-5.44043,4.45587,1.39563,5.01196,5.31603,1.6195,6.59922,4.92111,1.8914,8.23638,4.275,4.19583,2.23521,3.3751,5.73334,1.41174,2.43173,1.85989,2.35576,3.84318,4.98861,3.07465,3.08386,1.30326,1.41645,4.83109,1.30576,-.67278,6.41596,6.46517,.93712,1.68987,5.25866,.94581,2.97431,4.43234,.7221,3.52261,3.30068,.86164,3.87278,2.43018,1.13149,4.03903,1.82073,1.46795,4.22412,.56322,2.30769,5.56679,6.33814,-.52928,1.88118,5.5877,3.20807,2.68784,.24262,-1.46286,7.07149,1.61125,.33933,4.89542,7.74309,2.365,-2.00517,1.39114,1.85105,4.449,1.78579,-.97828,4.85047,4.67096,2.66446,3.08407,1.33397,-.28376,6.09705,7.2709,-2.89092,-2.25245,1.85643,2.58525,3.7579,.92339,.07308,6.67194,5.00059,-6.13513,1.89252,5.08528,-7.17859,.71471,7.15929,-.81182,-.07204,5.84305,-5.24802,.92409,6.84726,3.66292,.72469,2.41294,-8.25885,4.11921,.17991,-1.68986,6.5733,2.10366,-.16395,4.56612,6.40757,2.23602,1.56084,3.67007,2.36015,3.63523,3.17719,2.29427,3.7757,2.19612,-4.59832,4.47979,6.23488,-1.94443,1.66354,1.29292,-9.29592,4.09406,3.21065,-8.53328,2.802,4.06893,-7.99311,1.92512,2.72403,2.3158,3.77715,2.28846,2.39889,3.6976,1.99831,2.49655,3.68915,6.13004,3.39926,2.03852,2.28846,2.8865,3.77503,2.72403,2.96181,3.87177,3.17719,2.96414,3.87697,3.67007,2.92771,3.72432,4.01839,2.85736,3.48298,7.55581,4.10681,-.99192,4.01839,2.4837,3.4409,1.77622,-2.68395,5.21312,1.22224,-1.18244,5.95247,.73149,-2.53668,5.81534,4.13527,-6.99664,2.67197,3.31181,-7.66081,3.38296,1.3137,-8.63999,4.70246,5.94052,-6.22363,-.63147,1.99831,2.74384,3.74403,.90145,1.23699,5.75426,2.30898,-8.9742,3.60907,6.95415,-2.43984,-.13116,1.09882,-4.45879,5.12073,1.18112,-4.58,5.18956,1.25582,-4.7879,5.23705,1.32509,-5.10651,5.20501,1.54639,-5.81939,4.75789,1.95375,-4.18389,4.43171,2.1178,-4.13709,4.5551,2.28534,-4.0512,4.58244,2.85016,-3.66572,4.48499,5.27854,-2.23894,2.86122,.94671,1.90763,5.19678,1.31417,3.10491,4.2314,1.78,2.86,3.88155,1.84511,-4.09888,4.24726,5.43619,-4.03048,2.10985,.76644,3.18213,4.86145,1.93862,-6.61441,4.52109,.51657,1.58357,6.14836,1.24681,.2303,5.68104,.99783,-6.93092,4.97958,3.28881,-5.38251,3.79575,2.31163,-1.56624,4.59009,2.68025,-6.11157,4.09615,3.83293,-1.53733,4.13773,2.96186,-2.27421,4.44094,4.3869,-2.68329,3.64389,1.2173,-7.83446,4.96929,1.54237,-.13684,5.20101,3.87838,-6.04176,3.31108,3.08404,-6.80984,3.8142,3.74732,-4.50354,3.72645,6.09413,-3.20599,1.47348,4.58899,-4.72873,2.98322,6.58323,-3.94127,.07027,3.49258,-3.19582,4.1302,1.25554,.80234,5.30755,1.12612,-.9336,6.53878,1.44311,-1.14277,5.90513,.92304,-.52904,7.00342,1.75539,3.52912,4.3277,2.63259,3.71383,4.36463,3.38806,3.72198,4.30903,4.07577,3.67541,4.07606,4.62291,3.47469,3.64632,5.17175,2.53575,2.67087,7.29733,.76317,-.04877,4.70683,1.651,3.10953,4.07171,1.47682,3.47694,3.26982,1.47066,3.73195,2.52757,1.61731,3.86544,1.97089,1.85851,3.96178,1.57954,2.09794,4.085,7.66418,.67313,-2.43587,1.39704,-1.34014,5.63038,.88484,.65874,6.23323,.7671,-.96803,7.07793,.46021,-1.33411,6.78745,.74862,-1.06799,6.7983,1.23641,-1.58557,5.48049,.38731,-1.40999,6.95771,.31993,-1.60793,6.50868,1.63963,2.5563,3.86374,1.25565,2.46714,4.2038,1.03136,2.38266,4.61585,4.25308,2.7723,3.3153,4.53,2.91,3.33968]),N=[[1,0,-1.1269,7.4756],[4,0,-.4632,7.5866],[5,0,.3657,7.2429],[6,0,2.4733,5.7886],[8,0,4.019,5.2848],[9,0,4.886,5.3853],[10,0,8.2618,4.4815],[33,-4.4459,2.664,3.1734],[50,-4.7655,-.7016,3.5346],[67,-3.524,8.006,3.7292],[93,-7.5422,-1.0493,-2.4313],[103,-5.1332,7.4856,2.6604],[109,-1.8914,8.2364,4.275],[127,-7.7431,2.365,-2.0052],[133,-1.8564,2.5852,3.7579],[151,0,6.5454,5.0273],[168,0,3.271,5.236],[195,0,1.0594,6.7746],[197,0,1.7284,6.3167],[234,-7.6642,.6731,-2.4359],[263,4.4459,2.664,3.1734],[280,4.7655,-.7016,3.5346],[297,3.524,8.006,3.7292],[323,7.5422,-1.0493,-2.4313],[332,5.1332,7.4856,2.6604],[338,1.8914,8.2364,4.275],[356,7.7431,2.365,-2.0052],[362,1.8564,2.5852,3.7579],[454,7.6642,.6731,-2.4359],[463,1.6396,2.5563,3.8637],[243,-1.6396,2.5563,3.8637]],v=[0,-.46317,7.58658],_=Float64Array.from(N.flatMap(([,t,n,e])=>[t,n,e])),A=N.map(([t])=>t),j=(t,n)=>{const e=n??{scale:1,quaternion:new C.Quaternion,translation:new C.Vector3,rms:0,worldUnitsPerCm:1,count:0};return b.solveSimilarity(_,t,e),e.worldUnitsPerCm=e.scale,e.count=A.length,e},H=F.LANDMARK_POSE_FIT_DEFAULT_SMOOTHING,U={x:0,y:.5},W={x:1,y:.5},r=new C.Vector3,D=new C.Vector3,E=(t,{faceIndex:n,offset:e,smoothing:a=H,enabled:x=!0,onFit:P,onTrackingChange:g}={})=>{const s=w.useTrackerContext(),O=n??((s==null?void 0:s.type)==="face"?s.faceIndex:void 0)??0,c=G.useXRModelNode(l.XRModel.FACE_TRACKER),{camera:i}=q.useThree(),p=I.useCallback(d=>{var f,m;const u=(m=(f=c==null?void 0:c.detectionResults)==null?void 0:f.faceLandmarks)==null?void 0:m[O];if(!u||u.length<468)return!1;l.feedToWorld(U,i,r,0),l.feedToWorld(W,i,D,0);const y=r.distanceTo(D);for(let o=0;o<A.length;o+=1){const L=u[A[o]],R=-(L.z??0)*y;l.feedToWorld(L,i,r,R),d[o*3]=r.x,d[o*3+1]=r.y,d[o*3+2]=R}return!0},[i,O,c]);F.useLandmarkPoseFit(t,{canonical:_,readLive:p,offset:e,smoothing:a,enabled:x,onFit:P,onTrackingChange:g})},S=I.createContext(!1),K=({children:t,...n})=>{const e=I.useRef(null);return E(e,n),T.jsx(S.Provider,{value:!0,children:T.jsx("group",{ref:e,children:t})})};exports.CANONICAL_FACE_POSITIONS=k;exports.CANONICAL_HEAD_ANCHOR=v;exports.CANONICAL_HEAD_FIT_DEFAULT_SMOOTHING=H;exports.CANONICAL_RIGID_INDICES=A;exports.CANONICAL_RIGID_LANDMARKS=N;exports.CANONICAL_RIGID_POINTS=_;exports.CanonicalHeadFrame=K;exports.CanonicalHeadFrameContext=S;exports.solveCanonicalHeadPose=j;exports.useCanonicalHeadFit=E;