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

package/dist/internal-Bb9ZXbpr.cjs

@@ -0,0 +1 @@
+"use strict";var O=Object.defineProperty;var $=(t,e,r)=>e in t?O(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r;var n=(t,e,r)=>$(t,typeof e!="symbol"?e+"":e,r);const c=require("react/jsx-runtime"),i=require("react"),B=require("./selectors-QB2qsaxy.cjs"),K=require("./index-Sho4F4it.cjs"),V=require("@react-three/fiber");require("./hasFullUnitUVBounds-p1Dl0ejX.cjs");require("./uv-BMFt19bg.cjs");require("./FaceSurface-CHAMEeG1.cjs");const W=({children:t,defaultCollapsed:e=!0,title:r,width:s=320})=>{const[l,a]=i.useState(e);return l?c.jsx("button",{type:"button",onClick:()=>a(!1),"aria-label":`Open ${r}`,title:`Open ${r}`,style:{position:"absolute",right:16,bottom:16,zIndex:40,width:40,height:40,border:"1px solid rgba(255,255,255,0.12)",borderRadius:999,background:"rgba(15, 23, 42, 0.72)",color:"#e5eefb",boxShadow:"0 12px 30px rgba(0,0,0,0.18)",backdropFilter:"blur(10px)",cursor:"pointer",pointerEvents:"auto"},children:"◫"}):c.jsxs("div",{style:{position:"absolute",right:16,bottom:16,zIndex:40,width:s,maxWidth:"calc(100vw - 32px)",padding:14,borderRadius:14,boxShadow:"0 12px 30px rgba(0,0,0,0.26)",backdropFilter:"blur(10px)",pointerEvents:"auto",background:"rgba(15, 23, 42, 0.78)",border:"1px solid rgba(255,255,255,0.12)",color:"#e5eefb"},children:[c.jsxs("div",{style:{display:"flex",alignItems:"center",justifyContent:"space-between",gap:12,marginBottom:10},children:[c.jsx("div",{style:{fontSize:13,fontWeight:700},children:r}),c.jsx("button",{type:"button",onClick:()=>a(!0),"aria-label":`Close ${r}`,title:`Close ${r}`,style:{width:32,height:32,border:"1px solid rgba(255,255,255,0.12)",borderRadius:999,background:"rgba(255,255,255,0.04)",color:"#e5eefb",cursor:"pointer",flex:"0 0 auto"},children:"×"})]}),t]})};class X{constructor(){n(this,"frameTimestamps",[]);n(this,"lastUpdateTime",0);n(this,"currentFPS",0);n(this,"updateInterval",500);this.lastUpdateTime=performance.now()}trackFrame(){const e=performance.now();this.frameTimestamps.push(e);const r=e-this.updateInterval;this.frameTimestamps=this.frameTimestamps.filter(s=>s>r),e-this.lastUpdateTime>=this.updateInterval&&(this.currentFPS=this.frameTimestamps.length*2,this.lastUpdateTime=e)}getFPS(){return this.currentFPS}reset(){this.frameTimestamps=[],this.lastUpdateTime=performance.now(),this.currentFPS=0}}function J(t,e=1){return t.toFixed(e)}function P(t){return t/(1024*1024)}function G(t,e){return e===0?0:t/e*100}class Q{constructor(e=1e3){n(this,"intervalId",null);n(this,"memoryUsage",null);n(this,"updateInterval");n(this,"isSupported",!1);this.updateInterval=e,this.checkSupport()}checkSupport(){const e=performance;this.isSupported="memory"in e&&e.memory!==void 0,this.isSupported||console.warn("[MemoryTracker] performance.memory not available (Chrome-only API)")}start(){if(this.intervalId!==null){console.warn("[MemoryTracker] Already running");return}if(!this.isSupported){this.memoryUsage=null;return}this.updateMemory(),this.intervalId=window.setInterval(()=>{this.updateMemory()},this.updateInterval)}stop(){this.intervalId!==null&&(clearInterval(this.intervalId),this.intervalId=null)}updateMemory(){if(!this.isSupported)return;const e=performance;if(!e.memory)return;const r=e.memory.usedJSHeapSize,s=e.memory.jsHeapSizeLimit;this.memoryUsage={used:P(r),total:P(s),percentage:G(r,s)}}getMemoryUsage(){return this.memoryUsage}isMemorySupported(){return this.isSupported}}class Y{constructor(){n(this,"resolution","N/A");n(this,"videoElement",null);n(this,"metadataListener",null)}start(e){if(!e){this.resolution="N/A";return}this.videoElement=e,e.videoWidth>0&&e.videoHeight>0&&this.updateResolution(),this.metadataListener=()=>{this.updateResolution()},e.addEventListener("loadedmetadata",this.metadataListener)}stop(){this.videoElement&&this.metadataListener&&(this.videoElement.removeEventListener("loadedmetadata",this.metadataListener),this.metadataListener=null),this.videoElement=null,this.resolution="N/A"}updateResolution(){if(!this.videoElement){this.resolution="N/A";return}const e=this.videoElement.videoWidth,r=this.videoElement.videoHeight;e>0&&r>0?this.resolution=`${e}x${r}`:this.resolution="N/A"}getResolution(){return this.videoElement&&this.updateResolution(),this.resolution}}class Z{constructor(e={}){n(this,"options");n(this,"isRunning",!1);n(this,"metrics",{cameraFPS:0,detectionTime:0,modelPerformance:[],renderTime:0,effectiveFPS:0,memory:null,resolution:"N/A"});n(this,"cameraFPSTracker");n(this,"memoryTracker");n(this,"resolutionTracker");n(this,"frameTimes",[]);n(this,"lastEffectiveFPSUpdate",0);this.options={enableMemoryTracking:e.enableMemoryTracking??!0,memoryUpdateInterval:e.memoryUpdateInterval??1e3},this.cameraFPSTracker=new X,this.memoryTracker=new Q(this.options.memoryUpdateInterval),this.resolutionTracker=new Y}start(e){if(this.isRunning){console.warn("[MetricsCollector] Already running");return}this.isRunning=!0,this.lastEffectiveFPSUpdate=performance.now(),this.options.enableMemoryTracking&&this.memoryTracker.start(),e&&this.resolutionTracker.start(e),this.setupCameraFPSHook(),console.info("[MetricsCollector] Started")}stop(){this.isRunning&&(this.isRunning=!1,this.memoryTracker.stop(),this.resolutionTracker.stop(),this.cameraFPSTracker.reset(),this.cleanupCameraFPSHook(),console.info("[MetricsCollector] Stopped"))}setupCameraFPSHook(){const e=window;e.__xr_debugger_metrics||(e.__xr_debugger_metrics={trackCameraFrame:()=>{this.cameraFPSTracker.trackFrame(),this.metrics.cameraFPS=this.cameraFPSTracker.getFPS()}})}cleanupCameraFPSHook(){const e=window;e.__xr_debugger_metrics&&delete e.__xr_debugger_metrics}getMetrics(){return this.updateMetricsFromTrackers(),{...this.metrics}}updateMetricsFromTrackers(){this.isRunning&&(this.metrics.memory=this.memoryTracker.getMemoryUsage(),this.metrics.resolution=this.resolutionTracker.getResolution(),this.updateEffectiveFPS())}updateRenderTime(e){this.metrics.renderTime=e,this.updateEffectiveFPS()}async updateDetectionTime(e){if(!e||!this.isRunning){this.metrics.detectionTime=0,this.metrics.modelPerformance=[];return}try{const r=Object.values(e).filter(Boolean);if(r.length===0){this.metrics.detectionTime=0,this.metrics.modelPerformance=[];return}const s=r.map(o=>o&&typeof o.getPerformanceData=="function"?o.getPerformanceData():Promise.resolve({name:"unknown",processingTime:0})),l=await Promise.all(s);this.metrics.modelPerformance=l.map(o=>({name:o.name,processingTime:o.processingTime||0}));const a=l.reduce((o,p)=>o+(p.processingTime||0),0);this.metrics.detectionTime=a,this.updateEffectiveFPS()}catch(r){console.warn("[MetricsCollector] Error updating detection time:",r),this.metrics.detectionTime=0,this.metrics.modelPerformance=[]}}updateEffectiveFPS(){const e=performance.now(),r=this.metrics.detectionTime+this.metrics.renderTime;if(this.frameTimes.push(r),e-this.lastEffectiveFPSUpdate>=1e3){if(this.frameTimes.length>0){const s=this.frameTimes.reduce((l,a)=>l+a,0)/this.frameTimes.length;this.metrics.effectiveFPS=s>0?1e3/s:0}this.frameTimes=[],this.lastEffectiveFPSUpdate=e}}isActive(){return this.isRunning}}const C=i.lazy(async()=>({default:(await Promise.resolve().then(()=>require("./DebuggerUI-CVuV-VJ5.cjs"))).DebuggerUI})),y=i.createContext(null);function ee({children:t,keyboardShortcut:e="ctrl+shift+d",initialEnabled:r=!1,position:s="top-left",docked:l=!1}){const[a,o]=i.useState(r),[p,T]=i.useState(!1),[w,R]=i.useState({cameraFPS:0,detectionTime:0,modelPerformance:[],renderTime:0,effectiveFPS:0,memory:null,resolution:"N/A"}),f=i.useRef(null),m=i.useRef(null),g=i.useRef(!1),{session:b}=K.useXRContext(),S=B.useXRReady();i.useEffect(()=>(f.current||(f.current=new Z,window.__xr_metrics_collector=f.current),()=>{f.current&&f.current.stop(),m.current&&clearInterval(m.current),window.__xr_metrics_collector&&delete window.__xr_metrics_collector}),[]),i.useEffect(()=>{const u=f.current;if(u){if(a&&S){const d=b._getVideoElement();u.start(d),m.current=window.setInterval(async()=>{if(!g.current){g.current=!0;try{const k=Object.fromEntries(b.store.getSnapshot().pipeline);await u.updateDetectionTime(k),R(u.getMetrics())}finally{g.current=!1}}},100)}else u.stop(),m.current&&(clearInterval(m.current),m.current=null),g.current=!1;return()=>{m.current&&(clearInterval(m.current),m.current=null)}}},[a,S,b]),i.useEffect(()=>{const u=d=>{const h=e.toLowerCase().split("+"),M=h.includes("ctrl")||h.includes("control"),U=h.includes("shift"),j=h.includes("alt"),L=h[h.length-1],q=M?d.ctrlKey||d.metaKey:!0,A=U?d.shiftKey:!0,N=j?d.altKey:!0,H=d.key.toLowerCase()===L;q&&A&&N&&H&&(d.preventDefault(),o(z=>!z))};return window.addEventListener("keydown",u),()=>{window.removeEventListener("keydown",u)}},[e]);const E=i.useCallback(()=>{o(u=>!u)},[]),D=i.useCallback(()=>{o(!0)},[]),x=i.useCallback(()=>{o(!1)},[]),I={state:{enabled:a,collapsed:p,metrics:w},toggle:E,setCollapsed:T,enable:D,disable:x};return c.jsxs(y.Provider,{value:I,children:[t,a&&!l&&c.jsx(i.Suspense,{fallback:null,children:c.jsx(C,{metrics:w,collapsed:p,onCollapse:T,onClose:x,position:s,keyboardShortcut:e})})]})}function te({keyboardShortcut:t="ctrl+shift+d"}){const e=i.useContext(y);return!e||!e.state.enabled?null:c.jsx(i.Suspense,{fallback:null,children:c.jsx(C,{docked:!0,metrics:e.state.metrics,collapsed:e.state.collapsed,onCollapse:e.setCollapsed,onClose:e.disable,keyboardShortcut:t})})}function re(){const t=i.useContext(y);if(!t)throw new Error("useDebuggerContext must be used within a DebuggerProvider");return t}function se({onUpdate:t}){const e=i.useRef(0),r=i.useRef(!0);return V.useFrame(()=>{if(r.current)r.current=!1;else{const l=performance.now()-e.current;t(l)}e.current=performance.now()},-1e3),null}function F(){const t=re();return{metrics:t.state.metrics,enabled:t.state.enabled,collapsed:t.state.collapsed,toggle:t.toggle,setCollapsed:t.setCollapsed,enable:t.enable,disable:t.disable}}function ie(){const{enabled:t}=F(),e=r=>{const s=window;s.__xr_metrics_collector&&s.__xr_metrics_collector.updateRenderTime(r)};return t?c.jsx(se,{onUpdate:e}):null}const v=600;function _(){if(typeof window>"u")return;const t=window;return t.__xrCalibrationDebugState||(t.__xrCalibrationDebugState={events:[]}),t.__xrCalibrationDebugState}function ne(t,e,r){const s=_();s&&(s.events.push({source:t,label:e,payload:r,ts:performance.now()}),s.events.length>v&&s.events.splice(0,s.events.length-v))}function oe(t=v){const e=_();return e?e.events.slice(Math.max(0,e.events.length-t)):[]}exports.DebuggerOverlay=ie;exports.DebuggerPanel=te;exports.DebuggerProvider=ee;exports.XRDebugView=W;exports.formatNumber=J;exports.readCalibrationDebugEvents=oe;exports.recordCalibrationDebugEvent=ne;exports.useDebugger=F;

package/dist/{internal-KOKJDxCG.js → internal-Gt1wn6Z3.js}

@@ -1,20 +1,22 @@
-var B = Object.defineProperty;
-var K = (t, e, r) => e in t ? B(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r;
-var s = (t, e, r) => K(t, typeof e != "symbol" ? e + "" : e, r);
-import { jsx as f, jsxs as y } from "react/jsx-runtime";
-import O, { useState as p, useRef as g, useEffect as v, useCallback as T, createContext as W, Suspense as X, lazy as V } from "react";
-import { b as q } from "./selectors-BHO6TnoC.js";
-import { u as J } from "./index-CYMj26Ej.js";
-import { useFrame as G } from "@react-three/fiber";
+var X = Object.defineProperty;
+var V = (t, e, r) => e in t ? X(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r;
+var i = (t, e, r) => V(t, typeof e != "symbol" ? e + "" : e, r);
+import { jsx as m, jsxs as w } from "react/jsx-runtime";
+import q, { useState as b, useContext as J, createContext as G, Suspense as E, lazy as Q, useRef as p, useEffect as T, useCallback as y } from "react";
+import { d as Y } from "./selectors-BvJepq6H.js";
+import { u as Z } from "./index-CKRN-xJp.js";
+import { useFrame as ee } from "@react-three/fiber";
 import "./hasFullUnitUVBounds-BGvcFsQM.js";
-const fe = ({
+import "./uv-DJU_XfmN.js";
+import "./FaceSurface-DmP9AEeC.js";
+const ve = ({
   children: t,
   defaultCollapsed: e = !0,
   title: r,
-  width: i = 320
+  width: s = 320
 }) => {
-  const [n, o] = p(e);
-  return n ? /* @__PURE__ */ f(
+  const [a, o] = b(e);
+  return a ? /* @__PURE__ */ m(
     "button",
     {
       type: "button",
@@ -39,7 +41,7 @@ const fe = ({
       },
       children: "◫"
     }
-  ) : /* @__PURE__ */ y(
+  ) : /* @__PURE__ */ w(
     "div",
     {
       style: {
@@ -47,7 +49,7 @@ const fe = ({
         right: 16,
         bottom: 16,
         zIndex: 40,
-        width: i,
+        width: s,
         maxWidth: "calc(100vw - 32px)",
         padding: 14,
         borderRadius: 14,
@@ -59,7 +61,7 @@ const fe = ({
         color: "#e5eefb"
       },
       children: [
-        /* @__PURE__ */ y(
+        /* @__PURE__ */ w(
           "div",
           {
             style: {
@@ -70,8 +72,8 @@ const fe = ({
               marginBottom: 10
             },
             children: [
-              /* @__PURE__ */ f("div", { style: { fontSize: 13, fontWeight: 700 }, children: r }),
-              /* @__PURE__ */ f(
+              /* @__PURE__ */ m("div", { style: { fontSize: 13, fontWeight: 700 }, children: r }),
+              /* @__PURE__ */ m(
                 "button",
                 {
                   type: "button",
@@ -99,13 +101,13 @@ const fe = ({
     }
   );
 };
-class Q {
+class te {
   // 500ms as per PRD
   constructor() {
-    s(this, "frameTimestamps", []);
-    s(this, "lastUpdateTime", 0);
-    s(this, "currentFPS", 0);
-    s(this, "updateInterval", 500);
+    i(this, "frameTimestamps", []);
+    i(this, "lastUpdateTime", 0);
+    i(this, "currentFPS", 0);
+    i(this, "updateInterval", 500);
     this.lastUpdateTime = performance.now();
   }
   /**
@@ -116,7 +118,7 @@ class Q {
     const e = performance.now();
     this.frameTimestamps.push(e);
     const r = e - this.updateInterval;
-    this.frameTimestamps = this.frameTimestamps.filter((i) => i > r), e - this.lastUpdateTime >= this.updateInterval && (this.currentFPS = this.frameTimestamps.length * 2, this.lastUpdateTime = e);
+    this.frameTimestamps = this.frameTimestamps.filter((s) => s > r), e - this.lastUpdateTime >= this.updateInterval && (this.currentFPS = this.frameTimestamps.length * 2, this.lastUpdateTime = e);
   }
   /**
    * Get current FPS value
@@ -131,21 +133,21 @@ class Q {
     this.frameTimestamps = [], this.lastUpdateTime = performance.now(), this.currentFPS = 0;
   }
 }
-function he(t, e = 1) {
+function Te(t, e = 1) {
   return t.toFixed(e);
 }
-function _(t) {
+function R(t) {
   return t / (1024 * 1024);
 }
-function Y(t, e) {
+function re(t, e) {
   return e === 0 ? 0 : t / e * 100;
 }
-class Z {
+class se {
   constructor(e = 1e3) {
-    s(this, "intervalId", null);
-    s(this, "memoryUsage", null);
-    s(this, "updateInterval");
-    s(this, "isSupported", !1);
+    i(this, "intervalId", null);
+    i(this, "memoryUsage", null);
+    i(this, "updateInterval");
+    i(this, "isSupported", !1);
     this.updateInterval = e, this.checkSupport();
   }
   /**
@@ -184,11 +186,11 @@ class Z {
     if (!this.isSupported) return;
     const e = performance;
     if (!e.memory) return;
-    const r = e.memory.usedJSHeapSize, i = e.memory.jsHeapSizeLimit;
+    const r = e.memory.usedJSHeapSize, s = e.memory.jsHeapSizeLimit;
     this.memoryUsage = {
-      used: _(r),
-      total: _(i),
-      percentage: Y(r, i)
+      used: R(r),
+      total: R(s),
+      percentage: re(r, s)
     };
   }
   /**
@@ -205,11 +207,11 @@ class Z {
     return this.isSupported;
   }
 }
-class ee {
+class ie {
   constructor() {
-    s(this, "resolution", "N/A");
-    s(this, "videoElement", null);
-    s(this, "metadataListener", null);
+    i(this, "resolution", "N/A");
+    i(this, "videoElement", null);
+    i(this, "metadataListener", null);
   }
   /**
    * Start tracking resolution from a video element
@@ -247,12 +249,12 @@ class ee {
     return this.videoElement && this.updateResolution(), this.resolution;
   }
 }
-class te {
+class ne {
   constructor(e = {}) {
-    s(this, "options");
-    s(this, "isRunning", !1);
+    i(this, "options");
+    i(this, "isRunning", !1);
     // Current metrics state
-    s(this, "metrics", {
+    i(this, "metrics", {
       cameraFPS: 0,
       detectionTime: 0,
       modelPerformance: [],
@@ -262,16 +264,16 @@ class te {
       resolution: "N/A"
     });
     // Trackers
-    s(this, "cameraFPSTracker");
-    s(this, "memoryTracker");
-    s(this, "resolutionTracker");
+    i(this, "cameraFPSTracker");
+    i(this, "memoryTracker");
+    i(this, "resolutionTracker");
     // For effective FPS calculation
-    s(this, "frameTimes", []);
-    s(this, "lastEffectiveFPSUpdate", 0);
+    i(this, "frameTimes", []);
+    i(this, "lastEffectiveFPSUpdate", 0);
     this.options = {
       enableMemoryTracking: e.enableMemoryTracking ?? !0,
       memoryUpdateInterval: e.memoryUpdateInterval ?? 1e3
-    }, this.cameraFPSTracker = new Q(), this.memoryTracker = new Z(this.options.memoryUpdateInterval), this.resolutionTracker = new ee();
+    }, this.cameraFPSTracker = new te(), this.memoryTracker = new se(this.options.memoryUpdateInterval), this.resolutionTracker = new ie();
   }
   /**
    * Start collecting metrics
@@ -282,13 +284,13 @@ class te {
       console.warn("[MetricsCollector] Already running");
       return;
     }
-    this.isRunning = !0, this.lastEffectiveFPSUpdate = performance.now(), this.options.enableMemoryTracking && this.memoryTracker.start(), e && this.resolutionTracker.start(e), this.setupCameraFPSHook(), console.log("[MetricsCollector] Started");
+    this.isRunning = !0, this.lastEffectiveFPSUpdate = performance.now(), this.options.enableMemoryTracking && this.memoryTracker.start(), e && this.resolutionTracker.start(e), this.setupCameraFPSHook(), console.info("[MetricsCollector] Started");
   }
   /**
    * Stop collecting metrics and clean up
    */
   stop() {
-    this.isRunning && (this.isRunning = !1, this.memoryTracker.stop(), this.resolutionTracker.stop(), this.cameraFPSTracker.reset(), this.cleanupCameraFPSHook(), console.log("[MetricsCollector] Stopped"));
+    this.isRunning && (this.isRunning = !1, this.memoryTracker.stop(), this.resolutionTracker.stop(), this.cameraFPSTracker.reset(), this.cleanupCameraFPSHook(), console.info("[MetricsCollector] Stopped"));
   }
   /**
    * Setup global hook for camera FPS tracking
@@ -343,12 +345,12 @@ class te {
         this.metrics.detectionTime = 0, this.metrics.modelPerformance = [];
         return;
       }
-      const i = r.map((a) => a && typeof a.getPerformanceData == "function" ? a.getPerformanceData() : Promise.resolve({ name: "unknown", processingTime: 0 })), n = await Promise.all(i);
-      this.metrics.modelPerformance = n.map((a) => ({
-        name: a.name,
-        processingTime: a.processingTime || 0
+      const s = r.map((n) => n && typeof n.getPerformanceData == "function" ? n.getPerformanceData() : Promise.resolve({ name: "unknown", processingTime: 0 })), a = await Promise.all(s);
+      this.metrics.modelPerformance = a.map((n) => ({
+        name: n.name,
+        processingTime: n.processingTime || 0
       }));
-      const o = n.reduce((a, h) => a + (h.processingTime || 0), 0);
+      const o = a.reduce((n, h) => n + (h.processingTime || 0), 0);
       this.metrics.detectionTime = o, this.updateEffectiveFPS();
     } catch (r) {
       console.warn("[MetricsCollector] Error updating detection time:", r), this.metrics.detectionTime = 0, this.metrics.modelPerformance = [];
@@ -362,8 +364,8 @@ class te {
     const e = performance.now(), r = this.metrics.detectionTime + this.metrics.renderTime;
     if (this.frameTimes.push(r), e - this.lastEffectiveFPSUpdate >= 1e3) {
       if (this.frameTimes.length > 0) {
-        const i = this.frameTimes.reduce((n, o) => n + o, 0) / this.frameTimes.length;
-        this.metrics.effectiveFPS = i > 0 ? 1e3 / i : 0;
+        const s = this.frameTimes.reduce((a, o) => a + o, 0) / this.frameTimes.length;
+        this.metrics.effectiveFPS = s > 0 ? 1e3 / s : 0;
       }
       this.frameTimes = [], this.lastEffectiveFPSUpdate = e;
     }
@@ -375,14 +377,15 @@ class te {
     return this.isRunning;
   }
 }
-const re = V(async () => ({ default: (await import("./DebuggerUI-Dgop6Q6o.js")).DebuggerUI })), F = W(null);
-function pe({
+const I = Q(async () => ({ default: (await import("./DebuggerUI-D-rcPa54.js")).DebuggerUI })), k = G(null);
+function ye({
   children: t,
   keyboardShortcut: e = "ctrl+shift+d",
   initialEnabled: r = !1,
-  position: i = "top-left"
+  position: s = "top-left",
+  docked: a = !1
 }) {
-  const [n, o] = p(r), [a, h] = p(!1), [S, R] = p({
+  const [o, n] = b(r), [h, P] = b(!1), [x, D] = b({
     cameraFPS: 0,
     detectionTime: 0,
     modelPerformance: [],
@@ -390,87 +393,108 @@ function pe({
     effectiveFPS: 0,
     memory: null,
     resolution: "N/A"
-  }), d = g(null), l = g(null), { session: b } = J(), k = q();
-  v(() => (d.current || (d.current = new te(), window.__xr_metrics_collector = d.current), () => {
+  }), d = p(null), l = p(null), g = p(!1), { session: v } = Z(), F = Y();
+  T(() => (d.current || (d.current = new ne(), window.__xr_metrics_collector = d.current), () => {
     d.current && d.current.stop(), l.current && clearInterval(l.current), window.__xr_metrics_collector && delete window.__xr_metrics_collector;
-  }), []), v(() => {
+  }), []), T(() => {
     const c = d.current;
     if (c) {
-      if (n && k) {
-        const u = b._getVideoElement();
+      if (o && F) {
+        const u = v._getVideoElement();
         c.start(u), l.current = window.setInterval(async () => {
-          const x = Object.fromEntries(b.store.getSnapshot().pipeline);
-          await c.updateDetectionTime(x);
-          const m = c.getMetrics();
-          R(m);
-        }, 16);
+          if (!g.current) {
+            g.current = !0;
+            try {
+              const C = Object.fromEntries(v.store.getSnapshot().pipeline);
+              await c.updateDetectionTime(C), D(c.getMetrics());
+            } finally {
+              g.current = !1;
+            }
+          }
+        }, 100);
       } else
-        c.stop(), l.current && (clearInterval(l.current), l.current = null);
+        c.stop(), l.current && (clearInterval(l.current), l.current = null), g.current = !1;
       return () => {
         l.current && (clearInterval(l.current), l.current = null);
       };
     }
-  }, [n, k, b]), v(() => {
+  }, [o, F, v]), T(() => {
     const c = (u) => {
-      const m = e.toLowerCase().split("+"), D = m.includes("ctrl") || m.includes("control"), U = m.includes("shift"), L = m.includes("alt"), A = m[m.length - 1], N = D ? u.ctrlKey || u.metaKey : !0, H = U ? u.shiftKey : !0, z = L ? u.altKey : !0, j = u.key.toLowerCase() === A;
-      N && H && z && j && (u.preventDefault(), o(($) => !$));
+      const f = e.toLowerCase().split("+"), N = f.includes("ctrl") || f.includes("control"), H = f.includes("shift"), z = f.includes("alt"), j = f[f.length - 1], $ = N ? u.ctrlKey || u.metaKey : !0, B = H ? u.shiftKey : !0, K = z ? u.altKey : !0, O = u.key.toLowerCase() === j;
+      $ && B && K && O && (u.preventDefault(), n((W) => !W));
     };
     return window.addEventListener("keydown", c), () => {
       window.removeEventListener("keydown", c);
     };
   }, [e]);
-  const E = T(() => {
-    o((c) => !c);
-  }, []), M = T(() => {
-    o(!0);
-  }, []), P = T(() => {
-    o(!1);
-  }, []), I = {
+  const U = y(() => {
+    n((c) => !c);
+  }, []), L = y(() => {
+    n(!0);
+  }, []), _ = y(() => {
+    n(!1);
+  }, []), A = {
     state: {
-      enabled: n,
-      collapsed: a,
-      metrics: S
+      enabled: o,
+      collapsed: h,
+      metrics: x
     },
-    toggle: E,
-    setCollapsed: h,
-    enable: M,
-    disable: P
+    toggle: U,
+    setCollapsed: P,
+    enable: L,
+    disable: _
   };
-  return /* @__PURE__ */ y(F.Provider, { value: I, children: [
+  return /* @__PURE__ */ w(k.Provider, { value: A, children: [
     t,
-    n && /* @__PURE__ */ f(X, { fallback: null, children: /* @__PURE__ */ f(
-      re,
+    o && !a && /* @__PURE__ */ m(E, { fallback: null, children: /* @__PURE__ */ m(
+      I,
       {
-        metrics: S,
-        collapsed: a,
-        onCollapse: h,
-        onClose: P,
-        position: i,
+        metrics: x,
+        collapsed: h,
+        onCollapse: P,
+        onClose: _,
+        position: s,
         keyboardShortcut: e
       }
     ) })
   ] });
 }
-function ie() {
-  const t = O.useContext(F);
+function we({
+  keyboardShortcut: t = "ctrl+shift+d"
+}) {
+  const e = J(k);
+  return !e || !e.state.enabled ? null : /* @__PURE__ */ m(E, { fallback: null, children: /* @__PURE__ */ m(
+    I,
+    {
+      docked: !0,
+      metrics: e.state.metrics,
+      collapsed: e.state.collapsed,
+      onCollapse: e.setCollapsed,
+      onClose: e.disable,
+      keyboardShortcut: t
+    }
+  ) });
+}
+function oe() {
+  const t = q.useContext(k);
   if (!t)
     throw new Error("useDebuggerContext must be used within a DebuggerProvider");
   return t;
 }
-function se({ onUpdate: t }) {
-  const e = g(0), r = g(!0);
-  return G(() => {
+function ae({ onUpdate: t }) {
+  const e = p(0), r = p(!0);
+  return ee(() => {
     if (r.current)
       r.current = !1;
     else {
-      const n = performance.now() - e.current;
-      t(n);
+      const a = performance.now() - e.current;
+      t(a);
     }
     e.current = performance.now();
   }, -1e3), null;
 }
-function ne() {
-  const t = ie();
+function ce() {
+  const t = oe();
   return {
     metrics: t.state.metrics,
     enabled: t.state.enabled,
@@ -481,39 +505,40 @@ function ne() {
     disable: t.disable
   };
 }
-function ge() {
-  const { enabled: t } = ne(), e = (r) => {
-    const i = window;
-    i.__xr_metrics_collector && i.__xr_metrics_collector.updateRenderTime(r);
+function Se() {
+  const { enabled: t } = ce(), e = (r) => {
+    const s = window;
+    s.__xr_metrics_collector && s.__xr_metrics_collector.updateRenderTime(r);
   };
-  return t ? /* @__PURE__ */ f(se, { onUpdate: e }) : null;
+  return t ? /* @__PURE__ */ m(ae, { onUpdate: e }) : null;
 }
-const w = 600;
-function C() {
+const S = 600;
+function M() {
   if (typeof window > "u")
     return;
   const t = window;
   return t.__xrCalibrationDebugState || (t.__xrCalibrationDebugState = { events: [] }), t.__xrCalibrationDebugState;
 }
-function be(t, e, r) {
-  const i = C();
-  i && (i.events.push({
+function ke(t, e, r) {
+  const s = M();
+  s && (s.events.push({
     source: t,
     label: e,
     payload: r,
     ts: performance.now()
-  }), i.events.length > w && i.events.splice(0, i.events.length - w));
+  }), s.events.length > S && s.events.splice(0, s.events.length - S));
 }
-function ve(t = w) {
-  const e = C();
+function Pe(t = S) {
+  const e = M();
   return e ? e.events.slice(Math.max(0, e.events.length - t)) : [];
 }
 export {
-  pe as D,
-  fe as X,
-  ge as a,
-  be as b,
-  he as f,
-  ve as r,
-  ne as u
+  we as D,
+  ve as X,
+  ye as a,
+  Se as b,
+  ke as c,
+  Te as f,
+  Pe as r,
+  ce as u
 };

package/dist/internal.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./internal-DH5d1Xnq.cjs"),r=require("./hasFullUnitUVBounds-p1Dl0ejX.cjs"),n=require("./index-PtFmD6B8.cjs");exports.DebuggerOverlay=e.DebuggerOverlay;exports.DebuggerProvider=e.DebuggerProvider;exports.XRDebugView=e.XRDebugView;exports.readCalibrationDebugEvents=e.readCalibrationDebugEvents;exports.recordCalibrationDebugEvent=e.recordCalibrationDebugEvent;exports.useDebugger=e.useDebugger;exports._resetUVBoundsWarnings=r._resetUVBoundsWarnings;exports.logUVBoundsWarningOnce=r.logUVBoundsWarningOnce;exports.RENDER_LAYERS=n.RENDER_LAYERS;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./internal-Bb9ZXbpr.cjs"),n=require("./hasFullUnitUVBounds-p1Dl0ejX.cjs"),a=require("./uv-BMFt19bg.cjs"),r=require("./FaceSurface-CHAMEeG1.cjs"),u=require("./index-Sho4F4it.cjs");exports.DebuggerOverlay=e.DebuggerOverlay;exports.DebuggerPanel=e.DebuggerPanel;exports.DebuggerProvider=e.DebuggerProvider;exports.XRDebugView=e.XRDebugView;exports.readCalibrationDebugEvents=e.readCalibrationDebugEvents;exports.recordCalibrationDebugEvent=e.recordCalibrationDebugEvent;exports.useDebugger=e.useDebugger;exports._resetUVBoundsWarnings=n._resetUVBoundsWarnings;exports.logUVBoundsWarningOnce=n.logUVBoundsWarningOnce;exports.RENDER_LAYERS=a.RENDER_LAYERS;exports.FACE_SURFACE_FRAME_PRIORITY=r.FACE_SURFACE_FRAME_PRIORITY;exports.FaceSurfaceContext=r.FaceSurfaceContext;exports.createFaceSurfaceState=r.createFaceSurfaceState;exports.libConfig=u.libConfig;

package/dist/internal.js

@@ -1,14 +1,21 @@
-import { a, D as s, X as o, r as g, b as n, u } from "./internal-KOKJDxCG.js";
-import { _ as i, l as t } from "./hasFullUnitUVBounds-BGvcFsQM.js";
-import { R as d } from "./index-CYMj26Ej.js";
+import { b as r, D as s, a as o, X as g, r as t, c as n, u } from "./internal-Gt1wn6Z3.js";
+import { _ as i, l as c } from "./hasFullUnitUVBounds-BGvcFsQM.js";
+import { R } from "./uv-DJU_XfmN.js";
+import { F as E, a as l, c as x } from "./FaceSurface-DmP9AEeC.js";
+import { J as F } from "./index-CKRN-xJp.js";
 export {
-  a as DebuggerOverlay,
-  s as DebuggerProvider,
-  d as RENDER_LAYERS,
-  o as XRDebugView,
+  r as DebuggerOverlay,
+  s as DebuggerPanel,
+  o as DebuggerProvider,
+  E as FACE_SURFACE_FRAME_PRIORITY,
+  l as FaceSurfaceContext,
+  R as RENDER_LAYERS,
+  g as XRDebugView,
   i as _resetUVBoundsWarnings,
-  t as logUVBoundsWarningOnce,
-  g as readCalibrationDebugEvents,
+  x as createFaceSurfaceState,
+  F as libConfig,
+  c as logUVBoundsWarningOnce,
+  t as readCalibrationDebugEvents,
   n as recordCalibrationDebugEvent,
   u as useDebugger
 };

package/dist/iris/compute.d.ts

@@ -0,0 +1,27 @@
+import { IrisEye, IrisPoint, IrisResult, IrisSide } from './types';
+/** Eyelid opening (gap / eye width) at or above which an eye counts as fully open. */
+export declare const IRIS_FULL_OPENNESS = 0.2;
+export declare const createIrisEye: (side: IrisSide) => IrisEye;
+export declare const createIrisResult: (faceIndex?: number) => IrisResult;
+/**
+ * Derive one eye's iris data from a refined face-mesh landmark set (478
+ * points, MediaPipe image space). `side` is the person's own eye; `mirrored`
+ * says the frame is the mirrored webcam, where that eye is MediaPipe's other
+ * side (#298). Returns `false`, and marks the eye undetected, when the
+ * landmarks are missing. Allocation-free: writes into `eye`.
+ */
+export declare const computeIrisEye: (landmarks: ReadonlyArray<IrisPoint> | undefined, side: IrisSide, eye: IrisEye, confidenceScale?: number, mirrored?: boolean) => boolean;
+/**
+ * Update a full `IrisResult` from one face's landmarks. `faceConfidence` is
+ * 1 for a live face and the hold decay while held; it scales both eyes'
+ * confidence. `mirrored` says the frame is a mirror of the person (the
+ * session's webcam feed) so `left` / `right` stay the person's own eyes and
+ * `offset.x` keeps its anatomical sign. Pass `undefined` landmarks for an
+ * absent face.
+ */
+export declare const updateIrisResult: (result: IrisResult, landmarks: ReadonlyArray<IrisPoint> | undefined, nowMs: number, options?: {
+    faceIndex?: number;
+    held?: boolean;
+    faceConfidence?: number;
+    mirrored?: boolean;
+}) => IrisResult;

package/dist/iris/index.d.ts

@@ -0,0 +1,4 @@
+export { IRIS_FULL_OPENNESS, computeIrisEye, createIrisEye, createIrisResult, updateIrisResult, } from './compute';
+export { IrisLead } from './lead';
+export { IRIS_LANDMARKS, IRIS_LANDMARK_COUNT } from './types';
+export type { IrisEye, IrisPoint, IrisResult, IrisSide } from './types';

package/dist/iris/lead.d.ts

@@ -0,0 +1,19 @@
+import { IrisPoint } from './types';
+/**
+ * Bridges the gap between throttled inference samples and the render rate.
+ * Inference lands at, say, 24 fps while frames render at 60+, so a point
+ * that only updates on new samples holds then jumps. `observe` records each
+ * new sample and its velocity; `apply` advances the point along that
+ * velocity by the time since the sample, capped at `leadMs`, so motion
+ * reads continuous between samples. Reset on re-acquire.
+ */
+export declare class IrisLead {
+    private slots;
+    private readonly maxGapMs;
+    constructor(maxGapMs?: number);
+    reset(): void;
+    /** Record a fresh inference sample for `key` (e.g. "left"). */
+    observe(key: string, point: IrisPoint, nowMs: number): void;
+    /** Write the extrapolated position of `key` into `out`; a no-op before the first sample. */
+    apply(key: string, nowMs: number, leadMs: number, out: IrisPoint): IrisPoint;
+}