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

package/dist/internal-BjyhBP8i.cjs

@@ -1 +0,0 @@
-"use strict";var N=Object.defineProperty;var H=(t,e,r)=>e in t?N(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r;var i=(t,e,r)=>H(t,typeof e!="symbol"?e+"":e,r);const m=require("react/jsx-runtime"),n=require("react"),z=require("./selectors-BLl2JUWW.cjs"),O=require("./index-DxshgBu0.cjs"),$=require("@react-three/fiber");require("./hasFullUnitUVBounds-p1Dl0ejX.cjs");const B=({children:t,defaultCollapsed:e=!0,title:r,width:s=320})=>{const[o,a]=n.useState(e);return o?m.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:"◫"}):m.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:[m.jsxs("div",{style:{display:"flex",alignItems:"center",justifyContent:"space-between",gap:12,marginBottom:10},children:[m.jsx("div",{style:{fontSize:13,fontWeight:700},children:r}),m.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 K{constructor(){i(this,"frameTimestamps",[]);i(this,"lastUpdateTime",0);i(this,"currentFPS",0);i(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 V(t,e=1){return t.toFixed(e)}function S(t){return t/(1024*1024)}function W(t,e){return e===0?0:t/e*100}class X{constructor(e=1e3){i(this,"intervalId",null);i(this,"memoryUsage",null);i(this,"updateInterval");i(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:S(r),total:S(s),percentage:W(r,s)}}getMemoryUsage(){return this.memoryUsage}isMemorySupported(){return this.isSupported}}class J{constructor(){i(this,"resolution","N/A");i(this,"videoElement",null);i(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 G{constructor(e={}){i(this,"options");i(this,"isRunning",!1);i(this,"metrics",{cameraFPS:0,detectionTime:0,modelPerformance:[],renderTime:0,effectiveFPS:0,memory:null,resolution:"N/A"});i(this,"cameraFPSTracker");i(this,"memoryTracker");i(this,"resolutionTracker");i(this,"frameTimes",[]);i(this,"lastEffectiveFPSUpdate",0);this.options={enableMemoryTracking:e.enableMemoryTracking??!0,memoryUpdateInterval:e.memoryUpdateInterval??1e3},this.cameraFPSTracker=new K,this.memoryTracker=new X(this.options.memoryUpdateInterval),this.resolutionTracker=new J}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.log("[MetricsCollector] Started")}stop(){this.isRunning&&(this.isRunning=!1,this.memoryTracker.stop(),this.resolutionTracker.stop(),this.cameraFPSTracker.reset(),this.cleanupCameraFPSHook(),console.log("[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(c=>c&&typeof c.getPerformanceData=="function"?c.getPerformanceData():Promise.resolve({name:"unknown",processingTime:0})),o=await Promise.all(s);this.metrics.modelPerformance=o.map(c=>({name:c.name,processingTime:c.processingTime||0}));const a=o.reduce((c,p)=>c+(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((o,a)=>o+a,0)/this.frameTimes.length;this.metrics.effectiveFPS=s>0?1e3/s:0}this.frameTimes=[],this.lastEffectiveFPSUpdate=e}}isActive(){return this.isRunning}}const Q=n.lazy(async()=>({default:(await Promise.resolve().then(()=>require("./DebuggerUI-CatYc-RG.cjs"))).DebuggerUI})),x=n.createContext(null);function Y({children:t,keyboardShortcut:e="ctrl+shift+d",initialEnabled:r=!1,position:s="top-left"}){const[o,a]=n.useState(r),[c,p]=n.useState(!1),[v,_]=n.useState({cameraFPS:0,detectionTime:0,modelPerformance:[],renderTime:0,effectiveFPS:0,memory:null,resolution:"N/A"}),h=n.useRef(null),u=n.useRef(null),{session:g}=O.useXRContext(),T=z.useXRReady();n.useEffect(()=>(h.current||(h.current=new G,window.__xr_metrics_collector=h.current),()=>{h.current&&h.current.stop(),u.current&&clearInterval(u.current),window.__xr_metrics_collector&&delete window.__xr_metrics_collector}),[]),n.useEffect(()=>{const l=h.current;if(l){if(o&&T){const d=g._getVideoElement();l.start(d),u.current=window.setInterval(async()=>{const w=Object.fromEntries(g.store.getSnapshot().pipeline);await l.updateDetectionTime(w);const f=l.getMetrics();_(f)},16)}else l.stop(),u.current&&(clearInterval(u.current),u.current=null);return()=>{u.current&&(clearInterval(u.current),u.current=null)}}},[o,T,g]),n.useEffect(()=>{const l=d=>{const f=e.toLowerCase().split("+"),E=f.includes("ctrl")||f.includes("control"),M=f.includes("shift"),D=f.includes("alt"),I=f[f.length-1],U=E?d.ctrlKey||d.metaKey:!0,j=M?d.shiftKey:!0,L=D?d.altKey:!0,A=d.key.toLowerCase()===I;U&&j&&L&&A&&(d.preventDefault(),a(q=>!q))};return window.addEventListener("keydown",l),()=>{window.removeEventListener("keydown",l)}},[e]);const C=n.useCallback(()=>{a(l=>!l)},[]),F=n.useCallback(()=>{a(!0)},[]),y=n.useCallback(()=>{a(!1)},[]),R={state:{enabled:o,collapsed:c,metrics:v},toggle:C,setCollapsed:p,enable:F,disable:y};return m.jsxs(x.Provider,{value:R,children:[t,o&&m.jsx(n.Suspense,{fallback:null,children:m.jsx(Q,{metrics:v,collapsed:c,onCollapse:p,onClose:y,position:s,keyboardShortcut:e})})]})}function Z(){const t=n.useContext(x);if(!t)throw new Error("useDebuggerContext must be used within a DebuggerProvider");return t}function ee({onUpdate:t}){const e=n.useRef(0),r=n.useRef(!0);return $.useFrame(()=>{if(r.current)r.current=!1;else{const o=performance.now()-e.current;t(o)}e.current=performance.now()},-1e3),null}function k(){const t=Z();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 te(){const{enabled:t}=k(),e=r=>{const s=window;s.__xr_metrics_collector&&s.__xr_metrics_collector.updateRenderTime(r)};return t?m.jsx(ee,{onUpdate:e}):null}const b=600;function P(){if(typeof window>"u")return;const t=window;return t.__xrCalibrationDebugState||(t.__xrCalibrationDebugState={events:[]}),t.__xrCalibrationDebugState}function re(t,e,r){const s=P();s&&(s.events.push({source:t,label:e,payload:r,ts:performance.now()}),s.events.length>b&&s.events.splice(0,s.events.length-b))}function se(t=b){const e=P();return e?e.events.slice(Math.max(0,e.events.length-t)):[]}exports.DebuggerOverlay=te;exports.DebuggerProvider=Y;exports.XRDebugView=B;exports.formatNumber=V;exports.readCalibrationDebugEvents=se;exports.recordCalibrationDebugEvent=re;exports.useDebugger=k;

package/dist/modules/XRClient/index.d.ts

@@ -1,9 +0,0 @@
-import { XRClientConfig } from '../../types';
-export declare class XRClient {
-    private static instance;
-    private logger;
-    private session?;
-    static initialize(config: XRClientConfig): Promise<XRClient>;
-    private constructor();
-    createSession(): Promise<XRSession>;
-}

package/dist/modules/index.d.ts

@@ -1 +0,0 @@
-export * from './XRClient';

package/dist/screenImageSettings-6NRg4cx9.js

@@ -1,39 +0,0 @@
-const e = {
-  enabled: !0,
-  preset: "placeholder",
-  transformation: {
-    enabled: !0,
-    showFitGuides: !1,
-    coordinateSpace: "normalized",
-    canvasSize: { width: 720, height: 1280 },
-    position: { x: 0, y: -0.15 },
-    size: { width: 0.7, height: 0.7 },
-    rotation: 0,
-    pivot: [0.5, 0.5],
-    renderOrder: 999,
-    overlay: !0,
-    visible: !0
-  },
-  image: {
-    sourceKind: "default",
-    src: "",
-    stretchMode: "fit",
-    materialType: "unlit",
-    blendMode: "normal",
-    opacity: 1,
-    color: "#ffffff",
-    flipX: !1,
-    flipY: !1,
-    transparent: !0,
-    alphaTest: 0
-  }
-}, t = {
-  screenImage: e,
-  screenSpaceUI: {
-    enabled: !0
-  }
-};
-export {
-  e as D,
-  t as a
-};

package/dist/screenImageSettings-y_B4_767.cjs

@@ -1 +0,0 @@
-"use strict";const e={enabled:!0,preset:"placeholder",transformation:{enabled:!0,showFitGuides:!1,coordinateSpace:"normalized",canvasSize:{width:720,height:1280},position:{x:0,y:-.15},size:{width:.7,height:.7},rotation:0,pivot:[.5,.5],renderOrder:999,overlay:!0,visible:!0},image:{sourceKind:"default",src:"",stretchMode:"fit",materialType:"unlit",blendMode:"normal",opacity:1,color:"#ffffff",flipX:!1,flipY:!1,transparent:!0,alphaTest:0}},t={screenImage:e,screenSpaceUI:{enabled:!0}};exports.DEFAULT_SCREEN_IMAGE_SCENE_SETTINGS=t;exports.DEFAULT_SCREEN_IMAGE_SETTINGS=e;

package/dist/services/ApiService.d.ts

@@ -1,12 +0,0 @@
-/**
- * Wrapper class for making API requests.
- */
-export declare class ApiService {
-    private baseUrl;
-    private apiKey;
-    constructor(params: {
-        baseUrl: string;
-        apiKey: string;
-    });
-    fetch<T = unknown>(url: string, options?: RequestInit): Promise<T>;
-}

package/dist/types/client.d.ts

@@ -1,3 +0,0 @@
-export type XRClientConfig = {
-    apiKey: string;
-};

package/dist/useFaceResults-cpsSmKKc.js

@@ -1,81 +0,0 @@
-import { useState as x, useEffect as g } from "react";
-const E = (t) => {
-  if (t.length === 0)
-    return { minX: 0, minY: 0, maxX: 0, maxY: 0, width: 0, height: 0, centerX: 0, centerY: 0 };
-  let n = 1, e = 1, s = 0, a = 0;
-  for (let o = 0; o < t.length; o++) {
-    const { x: l, y: c } = t[o];
-    l < n && (n = l), c < e && (e = c), l > s && (s = l), c > a && (a = c);
-  }
-  const i = Math.max(0, s - n), h = Math.max(0, a - e);
-  return {
-    minX: n,
-    minY: e,
-    maxX: s,
-    maxY: a,
-    width: i,
-    height: h,
-    centerX: n + i * 0.5,
-    centerY: e + h * 0.5
-  };
-}, N = (t, n) => t.map((e) => ({
-  landmarks: e,
-  bounds: E(e)
-})), P = {
-  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
-}, X = (t, n, e, s, a) => {
-  if (n > 0) {
-    const i = { ...t, lastNonEmptyAt: e };
-    return e - t.lastPublishAt >= s ? {
-      action: "publish",
-      state: { publishedCount: n, lastPublishAt: e, lastNonEmptyAt: e }
-    } : { action: "none", state: i };
-  }
-  return t.publishedCount === 0 ? { action: "none", state: t } : t.lastNonEmptyAt >= 0 && e - t.lastNonEmptyAt < a ? { action: "none", state: t } : {
-    action: "clear",
-    // Reset the throttle anchor so the next reacquired face publishes at once.
-    state: { publishedCount: 0, lastPublishAt: -1 / 0, lastNonEmptyAt: t.lastNonEmptyAt }
-  };
-}, R = ({
-  node: t,
-  enabled: n,
-  selectedSource: e,
-  throttleMs: s = 16,
-  holdMs: a = 250,
-  onFrame: i
-}) => {
-  const [h, o] = x([]);
-  return g(() => {
-    if (!n || !t) {
-      o((u) => u.length === 0 ? u : []);
-      return;
-    }
-    let l = 0, c, m = P;
-    const p = (u, r, f) => {
-      const { action: A, state: y } = X(m, u, r, s, a);
-      m = y, A === "publish" ? o(f) : A === "clear" && o((d) => d.length === 0 ? d : []);
-    }, b = () => {
-      l = requestAnimationFrame(b), i == null || i();
-      const u = performance.now(), r = t.getDetectionResults();
-      if (!r) {
-        p(0, u, []), c = r;
-        return;
-      }
-      if (r === c) return;
-      c = r;
-      const f = N(
-        r.faceLandmarks ?? []
-      );
-      p(f.length, u, f);
-    };
-    return l = requestAnimationFrame(b), () => cancelAnimationFrame(l);
-  }, [n, t, e, s, i]), h;
-};
-export {
-  E as c,
-  R as u
-};

package/dist/useFaceResults-hVUJYSEY.cjs

@@ -1 +0,0 @@
-"use strict";const y=require("react"),x=t=>{if(t.length===0)return{minX:0,minY:0,maxX:0,maxY:0,width:0,height:0,centerX:0,centerY:0};let n=1,e=1,s=0,a=0;for(let u=0;u<t.length;u++){const{x:c,y:l}=t[u];c<n&&(n=c),l<e&&(e=l),c>s&&(s=c),l>a&&(a=l)}const i=Math.max(0,s-n),h=Math.max(0,a-e);return{minX:n,minY:e,maxX:s,maxY:a,width:i,height:h,centerX:n+i*.5,centerY:e+h*.5}},E=(t,n)=>t.map(e=>({landmarks:e,bounds:x(e)})),N={publishedCount:0,lastPublishAt:-1/0,lastNonEmptyAt:-1},R=(t,n,e,s,a)=>{if(n>0){const i={...t,lastNonEmptyAt:e};return e-t.lastPublishAt>=s?{action:"publish",state:{publishedCount:n,lastPublishAt:e,lastNonEmptyAt:e}}:{action:"none",state:i}}return t.publishedCount===0?{action:"none",state:t}:t.lastNonEmptyAt>=0&&e-t.lastNonEmptyAt<a?{action:"none",state:t}:{action:"clear",state:{publishedCount:0,lastPublishAt:-1/0,lastNonEmptyAt:t.lastNonEmptyAt}}},P=({node:t,enabled:n,selectedSource:e,throttleMs:s=16,holdMs:a=250,onFrame:i})=>{const[h,u]=y.useState([]);return y.useEffect(()=>{if(!n||!t){u(o=>o.length===0?o:[]);return}let c=0,l,f=N;const p=(o,r,m)=>{const{action:A,state:g}=R(f,o,r,s,a);f=g,A==="publish"?u(m):A==="clear"&&u(d=>d.length===0?d:[])},b=()=>{c=requestAnimationFrame(b),i==null||i();const o=performance.now(),r=t.getDetectionResults();if(!r){p(0,o,[]),l=r;return}if(r===l)return;l=r;const m=E(r.faceLandmarks??[]);p(m.length,o,m)};return c=requestAnimationFrame(b),()=>cancelAnimationFrame(c)},[n,t,e,s,i]),h};exports.computeLandmarkBounds=x;exports.useFaceResults=P;

package/dist/useXRModel-3DcUa28n.cjs

@@ -1 +0,0 @@
-"use strict";const e=require("react"),E=require("./index-DxshgBu0.cjs");function S(t,o,l=!0){const{session:r}=E.useXRContext(),s=e.useId(),[i,f]=e.useState(null),y=e.useMemo(()=>JSON.stringify(o??{}),[o]);e.useEffect(()=>{let u=!1;return f(null),r.registry.acquire(t,s,o).catch(c=>{u||f(c instanceof Error?c:new Error(String(c)))}),()=>{u=!0,r.registry.release(t,s)}},[r,t,s,y]),e.useEffect(()=>{r.registry.setActive(t,s,l)},[r,t,s,l]);const g=r.store,n=e.useSyncExternalStore(u=>g.subscribe(u),()=>g.getSnapshot().pipeline.get(t)??null,()=>null),d=e.useMemo(()=>n?n.getModelNode():null,[n]);return{ready:n!==null&&i===null,node:d,error:i}}exports.useXRModel=S;

package/dist/useXRModel-BMJE1hrk.js

@@ -1,28 +0,0 @@
-import { useId as p, useState as E, useMemo as g, useEffect as y, useSyncExternalStore as d } from "react";
-import { u as x } from "./index-safCs_af.js";
-function h(e, o, l = !0) {
-  const { session: r } = x(), t = p(), [c, i] = E(null), a = g(() => JSON.stringify(o ?? {}), [o]);
-  y(() => {
-    let s = !1;
-    return i(null), r.registry.acquire(e, t, o).catch((u) => {
-      s || i(u instanceof Error ? u : new Error(String(u)));
-    }), () => {
-      s = !0, r.registry.release(e, t);
-    };
-  }, [r, e, t, a]), y(() => {
-    r.registry.setActive(e, t, l);
-  }, [r, e, t, l]);
-  const f = r.store, n = d(
-    (s) => f.subscribe(s),
-    () => f.getSnapshot().pipeline.get(e) ?? null,
-    () => null
-  ), S = g(() => n ? n.getModelNode() : null, [n]);
-  return {
-    ready: n !== null && c === null,
-    node: S,
-    error: c
-  };
-}
-export {
-  h as u
-};