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

package/dist/scene-object/index.d.ts

@@ -0,0 +1,146 @@
+import { MeshRendererSettings } from '../components/MeshRenderer';
+import { FaceMeshRendererSettings } from '../components/FaceMesh';
+import { LightSettings } from '../components/LightObject';
+import { PinToMeshSettings } from '../components/PinToMesh';
+import { TrackingAnchorSettings } from '../components/TrackingAnchor';
+import { LookAtSettings } from '../components/LookAt';
+import { Transform3DSettings } from '../components/Transform3D';
+import { ScreenImageSettings } from '../screen-image/screenImageSettings';
+import { ScreenTextSettings } from '../screen-text/screenTextSettings';
+import { ScreenShapeSettings } from '../components/ScreenShape';
+import { ScreenTransform2DSettings } from '../screen2d';
+export type SceneObjectId = string;
+export type SceneComponentId = string;
+export type MaterialSettings = {
+    type: "standard" | "basic";
+    color: string;
+    opacity: number;
+    wireframe: boolean;
+    roughness: number;
+    metalness: number;
+};
+export type TextureSettings = {
+    sourceId?: string;
+    url?: string;
+    flipX: boolean;
+    flipY: boolean;
+};
+export type ComponentRegistry = {
+    Transform: Transform3DSettings;
+    ScreenTransform: ScreenTransform2DSettings;
+    ScreenImage: ScreenImageSettings;
+    ScreenText: ScreenTextSettings;
+    ScreenShape: ScreenShapeSettings;
+    MeshRenderer: MeshRendererSettings;
+    FaceMeshRenderer: FaceMeshRendererSettings;
+    Material: MaterialSettings;
+    Texture: TextureSettings;
+    Light: LightSettings;
+    LookAt: LookAtSettings;
+    PinToMesh: PinToMeshSettings;
+    TrackingAnchor: TrackingAnchorSettings;
+};
+export type SceneComponentType = keyof ComponentRegistry;
+export type SceneObject = {
+    id: SceneObjectId;
+    name: string;
+    enabled: boolean;
+    /**
+     * Optional parent scene object. Child transforms are evaluated in the
+     * parent's runtime Object3D space, so moving/rotating/scaling the parent
+     * affects all descendants while each child keeps its own local transform.
+     */
+    parentObjectId?: SceneObjectId | null;
+    /** Ordered child scene-object IDs for hierarchy/runtime nesting. */
+    childObjectIds?: SceneObjectId[];
+    renderGroupId?: string;
+    /** @deprecated Use renderGroupId. Retained for persisted-scene migration. */
+    layerId?: string;
+    componentIds: SceneComponentId[];
+};
+export type SceneComponent<TType extends SceneComponentType = SceneComponentType> = TType extends SceneComponentType ? {
+    id: SceneComponentId;
+    objectId: SceneObjectId;
+    type: TType;
+    enabled: boolean;
+    settings: ComponentRegistry[TType];
+} : never;
+export type SceneObjectStore = {
+    objects: Record<SceneObjectId, SceneObject>;
+    components: Record<SceneComponentId, SceneComponent>;
+};
+export declare const createSceneId: (prefix: string) => string;
+export declare const createSceneObjectId: () => string;
+export declare const createSceneComponentId: () => string;
+export declare const createDefaultTransformSettings: () => Transform3DSettings;
+export declare const createDefaultScreenTransformSettings: () => ScreenTransform2DSettings;
+export declare const createDefaultScreenImageSettings: () => ScreenImageSettings;
+export declare const createDefaultScreenTextSettings: () => ScreenTextSettings;
+export declare const createDefaultScreenShapeSettings: () => ScreenShapeSettings;
+export declare const createDefaultMeshRendererSettings: () => MeshRendererSettings;
+export declare const createDefaultFaceMeshRendererSettings: () => FaceMeshRendererSettings;
+export declare const createDefaultMaterialSettings: () => MaterialSettings;
+export declare const createDefaultTextureSettings: () => TextureSettings;
+export declare const createDefaultLightSettings: () => LightSettings;
+export declare const createDefaultLookAtSettings: () => {
+    enabled: boolean;
+    targetObjectId: SceneObjectId | null;
+    mode: "point";
+    inheritChildren: boolean;
+    offsetRotation: {
+        x: number;
+        y: number;
+        z: number;
+    };
+};
+export declare const createDefaultPinToMeshSettings: () => PinToMeshSettings;
+export declare const createDefaultTrackingAnchorSettings: () => TrackingAnchorSettings;
+export declare const componentDefaults: {
+    Transform: () => Transform3DSettings;
+    ScreenTransform: () => ScreenTransform2DSettings;
+    ScreenImage: () => ScreenImageSettings;
+    ScreenText: () => ScreenTextSettings;
+    ScreenShape: () => ScreenShapeSettings;
+    MeshRenderer: () => MeshRendererSettings;
+    FaceMeshRenderer: () => FaceMeshRendererSettings;
+    Material: () => MaterialSettings;
+    Texture: () => TextureSettings;
+    Light: () => LightSettings;
+    LookAt: () => {
+        enabled: boolean;
+        targetObjectId: SceneObjectId | null;
+        mode: "point";
+        inheritChildren: boolean;
+        offsetRotation: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    };
+    PinToMesh: () => PinToMeshSettings;
+    TrackingAnchor: () => TrackingAnchorSettings;
+};
+export declare const createSceneObject: ({ componentIds, enabled, id, parentObjectId, childObjectIds, renderGroupId, layerId, name, }: {
+    componentIds?: SceneComponentId[];
+    enabled?: boolean;
+    id?: SceneObjectId;
+    parentObjectId?: SceneObjectId | null;
+    childObjectIds?: SceneObjectId[];
+    renderGroupId?: string;
+    /** @deprecated Use renderGroupId. */
+    layerId?: string;
+    name: string;
+}) => SceneObject;
+export declare const createDefaultComponent: <TType extends SceneComponentType>(type: TType, objectId: SceneObjectId) => SceneComponent<TType>;
+export declare const getOrderedComponents: (store: SceneObjectStore, objectId: SceneObjectId) => SceneComponent[];
+export declare const createOrderedComponentsSelector: () => (store: SceneObjectStore, objectId: SceneObjectId) => SceneComponent[];
+export declare const addComponentToObject: <TStore extends SceneObjectStore>(store: TStore, component: SceneComponent) => TStore;
+export declare const moveComponent: <TStore extends SceneObjectStore>(store: TStore, objectId: SceneObjectId, componentId: SceneComponentId, nextIndex: number) => TStore;
+export declare const removeComponent: <TStore extends SceneObjectStore>(store: TStore, objectId: SceneObjectId, componentId: SceneComponentId) => TStore;
+export declare const replaceSceneComponent: <TStore extends SceneObjectStore>(store: TStore, component: SceneComponent) => TStore;
+export declare const replaceSceneObject: <TStore extends SceneObjectStore>(store: TStore, object: SceneObject) => TStore;
+export declare const getSceneObjectChildren: (store: SceneObjectStore, objectId: SceneObjectId) => SceneObject[];
+export declare const setSceneObjectParent: <TStore extends SceneObjectStore>(store: TStore, objectId: SceneObjectId, parentObjectId: SceneObjectId | null, nextIndex?: number) => TStore;
+export declare const setSceneObjectParentPreserveWorldTransform: <TStore extends SceneObjectStore>(store: TStore, objectId: SceneObjectId, parentObjectId: SceneObjectId | null, nextIndex?: number) => TStore;
+export declare const setSceneObjectVisible: <TStore extends SceneObjectStore>(store: TStore, objectId: SceneObjectId, visible: boolean) => TStore;
+export declare const deleteSceneObject: <TStore extends SceneObjectStore>(store: TStore, objectId: SceneObjectId) => TStore;

package/dist/scene-object/runtimeRegistry.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+import { Object3D } from 'three';
+export type RuntimeObjectRegistry = {
+    register: (id: string, object: Object3D | null) => void;
+    resolve: (id: string | null | undefined) => Object3D | null;
+};
+export declare const RuntimeObjectRegistryProvider: ({ children }: {
+    children: ReactNode;
+}) => import('react').FunctionComponentElement<import('react').ProviderProps<RuntimeObjectRegistry | null>>;
+export declare const useRuntimeObjectRegistry: () => RuntimeObjectRegistry;
+export declare const useRegisterRuntimeObject: () => (id: string, object: Object3D | null) => void;
+export declare const useResolveRuntimeObject: () => (id: string | null | undefined) => Object3D | null;
+export declare const registerRuntimeObject: (id: string, object: Object3D | null) => void;
+export declare const resolveRuntimeObject: (id: string | null | undefined) => Object3D | null;

package/dist/scene-object.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./renderPasses-CT5iBwtg.cjs"),t=require("./renderGroups-Dvm1J4lW.cjs");exports.addComponentToObject=e.addComponentToObject;exports.componentDefaults=e.componentDefaults;exports.createDefaultComponent=e.createDefaultComponent;exports.createDefaultFaceMeshRendererSettings=e.createDefaultFaceMeshRendererSettings;exports.createDefaultMaterialSettings=e.createDefaultMaterialSettings;exports.createDefaultMeshRendererSettings=e.createDefaultMeshRendererSettings;exports.createDefaultScreenImageSettings=e.createDefaultScreenImageSettings;exports.createDefaultScreenShapeSettings=e.createDefaultScreenShapeSettings;exports.createDefaultScreenTextSettings=e.createDefaultScreenTextSettings;exports.createDefaultScreenTransformSettings=e.createDefaultScreenTransformSettings;exports.createDefaultTextureSettings=e.createDefaultTextureSettings;exports.createDefaultTransformSettings=e.createDefaultTransformSettings;exports.createOrderedComponentsSelector=e.createOrderedComponentsSelector;exports.createSceneComponentId=e.createSceneComponentId;exports.createSceneId=e.createSceneId;exports.createSceneObject=e.createSceneObject;exports.createSceneObjectId=e.createSceneObjectId;exports.deleteSceneObject=e.deleteSceneObject;exports.getOrderedComponents=e.getOrderedComponents;exports.getSceneObjectChildren=e.getSceneObjectChildren;exports.moveComponent=e.moveComponent;exports.removeComponent=e.removeComponent;exports.replaceSceneComponent=e.replaceSceneComponent;exports.replaceSceneObject=e.replaceSceneObject;exports.setSceneObjectParent=e.setSceneObjectParent;exports.setSceneObjectParentPreserveWorldTransform=e.setSceneObjectParentPreserveWorldTransform;exports.setSceneObjectVisible=e.setSceneObjectVisible;exports.DEFAULT_RENDER_GROUP_IDS=t.DEFAULT_RENDER_GROUP_IDS;exports.RENDER_GROUP_POLICIES=t.RENDER_GROUP_POLICIES;exports.createRenderPlan=t.createRenderPlan;exports.getDefaultRenderGroupId=t.getDefaultRenderGroupId;exports.migrateToRenderGroups=t.migrateToRenderGroups;exports.moveObjectToGroup=t.moveObjectToGroup;exports.reorderObjectWithinGroup=t.reorderObjectWithinGroup;exports.reorderRenderGroup=t.reorderRenderGroup;exports.validateGroupCompatibility=t.validateGroupCompatibility;

package/dist/scene-object.js

@@ -0,0 +1,40 @@
+import { a, c as r, b as s, d as n, e as c, f as o, g as S, i as l, h as d, j as m, k as p, l as i, q as u, m as f, n as D, o as g, p as O, r as b, s as R, t as j, u as C, v as T, w as G, x as I, y as v, z as P, A as h } from "./renderPasses-CjgG_6kQ.js";
+import { D as x, R as _, c as M, g as U, m as y, a as A, r as F, b as L, v as N } from "./renderGroups-C9QJrAXu.js";
+export {
+  x as DEFAULT_RENDER_GROUP_IDS,
+  _ as RENDER_GROUP_POLICIES,
+  a as addComponentToObject,
+  r as componentDefaults,
+  s as createDefaultComponent,
+  n as createDefaultFaceMeshRendererSettings,
+  c as createDefaultMaterialSettings,
+  o as createDefaultMeshRendererSettings,
+  S as createDefaultScreenImageSettings,
+  l as createDefaultScreenShapeSettings,
+  d as createDefaultScreenTextSettings,
+  m as createDefaultScreenTransformSettings,
+  p as createDefaultTextureSettings,
+  i as createDefaultTransformSettings,
+  u as createOrderedComponentsSelector,
+  M as createRenderPlan,
+  f as createSceneComponentId,
+  D as createSceneId,
+  g as createSceneObject,
+  O as createSceneObjectId,
+  b as deleteSceneObject,
+  U as getDefaultRenderGroupId,
+  R as getOrderedComponents,
+  j as getSceneObjectChildren,
+  y as migrateToRenderGroups,
+  C as moveComponent,
+  A as moveObjectToGroup,
+  T as removeComponent,
+  F as reorderObjectWithinGroup,
+  L as reorderRenderGroup,
+  G as replaceSceneComponent,
+  I as replaceSceneObject,
+  v as setSceneObjectParent,
+  P as setSceneObjectParentPreserveWorldTransform,
+  h as setSceneObjectVisible,
+  N as validateGroupCompatibility
+};

package/dist/{screenImageSettings.d.ts → screen-image/screenImageSettings.d.ts}

@@ -1,5 +1,6 @@
-import { ScreenImageBlendMode, ScreenImageMaterialType, ScreenImageStretchMode } from './components/ScreenImage';
-import { ScreenCanvasSize, ScreenCoordinateSpace } from './screen2d';
+import { ScreenImageProps, ScreenImageBlendMode, ScreenImageMaterialType, ScreenImageStretchMode } from '../components/ScreenImage';
+import { ScreenCanvasSize, ScreenCoordinateSpace } from '../screen2d';
+import { ScreenTransform2DSettings } from '../screen2d/screenTransform';
 import { ScreenImagePreset } from './screenImagePresets';
 export type ScreenImageSourceKind = "default" | "image" | "texture" | "video" | "sequence" | "gif";
 export type ScreenImageTransformationSettings = {
@@ -37,6 +38,7 @@ export type ScreenImageImageSettings = {
 export type ScreenImageSettings = {
     enabled: boolean;
     preset: ScreenImagePreset;
+    screenTransform?: ScreenTransform2DSettings;
     transformation: ScreenImageTransformationSettings;
     image: ScreenImageImageSettings;
 };
@@ -46,5 +48,10 @@ export type ScreenImageSceneSettings = {
         enabled: boolean;
     };
 };
+export type ScreenImageRenderMapping = {
+    shouldRender: boolean;
+    props: Omit<ScreenImageProps, "backdropTexture" | "onScreenTransformChange">;
+};
+export declare function mapScreenImageSettingsToProps(settings: ScreenImageSceneSettings): ScreenImageRenderMapping;
 export declare const DEFAULT_SCREEN_IMAGE_SETTINGS: ScreenImageSettings;
 export declare const DEFAULT_SCREEN_IMAGE_SCENE_SETTINGS: ScreenImageSceneSettings;

package/dist/{screenTextSettings.d.ts → screen-text/screenTextSettings.d.ts}

@@ -1,5 +1,7 @@
-import { ScreenImageSettings } from './screenImageSettings';
-import { ScreenCanvasSize, ScreenCoordinateSpace } from './screen2d';
+import { ScreenImageSettings } from '../screen-image/screenImageSettings';
+import { ScreenTextProps } from '../components/ScreenText';
+import { ScreenCanvasSize, ScreenCoordinateSpace } from '../screen2d';
+import { ScreenTransform2DSettings } from '../screen2d/screenTransform';
 export type ScreenTextArtPreset = "clean" | "sticker" | "shadow-pop" | "neon" | "editorial" | "comic-burst" | "ice-outline" | "sunset-glow" | "cutout" | "badge-arc" | "chrome-bulge" | "retro-wave" | "flag-pop" | "fisheye-poster";
 export type ScreenTextContent = {
     text: string;
@@ -76,6 +78,7 @@ export type ScreenTextStyle = {
     bold?: boolean;
     fontStyle?: "normal" | "italic";
     underline?: boolean;
+    strikethrough?: boolean;
     letterSpacing: number;
     lineSpacing: number;
     color: string;
@@ -98,6 +101,7 @@ export type ScreenTextSettings = {
     content: ScreenTextContent;
     layout: ScreenTextLayout;
     style: ScreenTextStyle;
+    screenTransform?: ScreenTransform2DSettings;
     transformation: ScreenTextTransformationSettings;
     textArtPreset: ScreenTextArtPreset;
 };
@@ -127,5 +131,17 @@ export type ScreenTextSceneSettings = {
         enabled: boolean;
     };
 };
+export type ScreenTextRenderMapping = {
+    shouldRender: boolean;
+    props: Omit<ScreenTextProps, "onScreenTransformChange">;
+};
+export declare function mapScreenTextInnerShadowToProps(innerShadow?: ScreenTextInnerShadow): {
+    color: string;
+    opacity: number | undefined;
+    blur: number;
+    offsetX: number;
+    offsetY: number;
+} | undefined;
+export declare function mapScreenTextSettingsToProps(settings: ScreenTextSceneSettings): ScreenTextRenderMapping;
 export declare const DEFAULT_SCREEN_TEXT_SHADOW_LAYER: ScreenTextShadowLayer;
 export declare const DEFAULT_SCREEN_TEXT_SCENE_SETTINGS: ScreenTextSceneSettings;

package/dist/screen2d/coordinates.d.ts

@@ -0,0 +1,87 @@
+import { Camera, Ray, Vector3Like } from 'three';
+import { ScreenTransformRoot } from './screenTransform';
+import { XRMediaLayout } from '../types/compositor';
+export type ScreenViewportSize = {
+    width: number;
+    height: number;
+};
+export type ScreenPixelPoint = {
+    x: number;
+    y: number;
+};
+export type ProjectedScreenPixelPoint = ScreenPixelPoint & {
+    depth: number;
+};
+export type ScreenClientRect = ScreenViewportSize & {
+    left: number;
+    top: number;
+};
+export type ScreenUnitConversionOptions = {
+    parentSize: ScreenViewportSize;
+    referencePixelsPerUnit?: number;
+    root?: ScreenTransformRoot;
+};
+/** Converts SDK design-canvas pixels to Three.js ScreenSpaceUI plane units. */
+export declare const screenPixelsToUnits: (pixels: number, options: ScreenUnitConversionOptions) => number;
+/** Converts Three.js ScreenSpaceUI plane units to SDK design-canvas pixels. */
+export declare const screenUnitsToPixels: (units: number, options: ScreenUnitConversionOptions) => number;
+/** Converts DOM client coordinates to center-origin, +Y-up SDK design pixels. */
+export declare const clientToScreenPixels: ({ point, rect, root, target, }: {
+    point: ScreenPixelPoint;
+    rect: ScreenClientRect;
+    root?: ScreenTransformRoot;
+    target?: ScreenPixelPoint;
+}) => ScreenPixelPoint;
+/** Converts SDK design pixels to DOM client coordinates. */
+export declare const screenPixelsToClient: ({ point, rect, root, target, }: {
+    point: ScreenPixelPoint;
+    rect: ScreenClientRect;
+    root?: ScreenTransformRoot;
+    target?: ScreenPixelPoint;
+}) => ScreenPixelPoint;
+/** Converts normalized viewport coordinates (top-left origin) to SDK design pixels. */
+export declare const normalizedToScreenPixels: ({ point, root, target, viewportSize, }: {
+    point: ScreenPixelPoint;
+    viewportSize: ScreenViewportSize;
+    root?: ScreenTransformRoot;
+    target?: ScreenPixelPoint;
+}) => ScreenPixelPoint;
+/** Converts SDK design pixels to normalized viewport coordinates (top-left origin). */
+export declare const screenPixelsToNormalized: ({ point, root, target, viewportSize, }: {
+    point: ScreenPixelPoint;
+    viewportSize: ScreenViewportSize;
+    root?: ScreenTransformRoot;
+    target?: ScreenPixelPoint;
+}) => ScreenPixelPoint;
+/** Maps source-media pixel coordinates through viewport fit/crop and optional mirroring. */
+export declare const mediaToScreenPixels: ({ layout, mirrored, point, root, target, }: {
+    point: ScreenPixelPoint;
+    layout: XRMediaLayout;
+    mirrored?: boolean;
+    root?: ScreenTransformRoot;
+    target?: ScreenPixelPoint;
+}) => ScreenPixelPoint;
+/** Maps SDK design pixels back into source-media pixel coordinates. */
+export declare const screenPixelsToMedia: ({ layout, mirrored, point, root, target, }: {
+    point: ScreenPixelPoint;
+    layout: XRMediaLayout;
+    mirrored?: boolean;
+    root?: ScreenTransformRoot;
+    target?: ScreenPixelPoint;
+}) => ScreenPixelPoint;
+/** Projects a world position into center-origin, +Y-up SDK design pixels. */
+export declare const worldToScreenPixels: ({ camera, point, root, target, viewportSize, }: {
+    point: Vector3Like;
+    camera: Camera;
+    viewportSize: ScreenViewportSize;
+    root?: ScreenTransformRoot;
+    target?: ProjectedScreenPixelPoint;
+}) => ProjectedScreenPixelPoint;
+/** Casts a ray from center-origin, +Y-up SDK design pixels into the 3D scene. */
+export declare const screenPointToRay: ({ camera, point, root, target, viewportSize, }: {
+    point: ScreenPixelPoint;
+    camera: Camera;
+    viewportSize: ScreenViewportSize;
+    root?: ScreenTransformRoot;
+    target?: Ray;
+}) => Ray;

package/dist/screen2d/index.d.ts

@@ -2,3 +2,6 @@ export * from './types';
 export * from './material-runtime';
 export * from './texture';
 export * from './transform';
+export * from './screenTransform';
+export * from './coordinates';
+export * from './smoothing';

package/dist/screen2d/screenTransform.d.ts

@@ -0,0 +1,47 @@
+export type ScreenTransform2DSettings = {
+    enabled: boolean;
+    position: {
+        x: number;
+        y: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    pivot: [number, number];
+    rotation: number;
+    scale2D: {
+        x: number;
+        y: number;
+    };
+    referencePixelsPerUnit: number;
+    renderOrder: number;
+    overlay: boolean;
+    visible: boolean;
+    showTransformGuides: boolean;
+};
+export type ScreenTransformRoot = {
+    width: number;
+    height: number;
+};
+export type ResolvedScreenTransform2D = {
+    center: [number, number, number];
+    size: [number, number, number];
+    rotation: [number, number, number];
+    pivotOffset: [number, number, number];
+    aspect: number;
+};
+export declare const DEFAULT_SCREEN_TRANSFORM_ROOT: ScreenTransformRoot;
+export declare const DEFAULT_REFERENCE_PIXELS_PER_UNIT = 32;
+export declare const DEFAULT_PIXEL_SNAP_INCREMENT = 0.5;
+export declare const DEFAULT_SCREEN_TRANSFORM_2D: ScreenTransform2DSettings;
+export declare const resolveScreenTransform2D: ({ transform, parentSize, root, snapIncrement, }: {
+    transform: ScreenTransform2DSettings;
+    parentSize: {
+        width: number;
+        height: number;
+    };
+    root?: ScreenTransformRoot;
+    snapIncrement?: number;
+}) => ResolvedScreenTransform2D;
+export declare const mergeScreenTransform2D: (transform?: Partial<ScreenTransform2DSettings>) => ScreenTransform2DSettings;

package/dist/screen2d/smoothing.d.ts

@@ -0,0 +1,5 @@
+import { Vector2, Vector3 } from 'three';
+/** Frame-rate-independent exponential smoothing. */
+export declare const smoothNumber: (current: number, target: number, rate: number, deltaSeconds: number) => number;
+export declare const smoothVector2: (current: Vector2, target: Vector2, rate: number, deltaSeconds: number, out?: Vector2) => Vector2;
+export declare const smoothVector3: (current: Vector3, target: Vector3, rate: number, deltaSeconds: number, out?: Vector3) => Vector3;

package/dist/{selectors-BLl2JUWW.cjs → selectors-2QvO5RYY.cjs}

@@ -1 +1 @@
-"use strict";const s=require("react"),u=require("./index-DxshgBu0.cjs"),o=()=>u.useXRContext().session.store,n=e=>t=>e.subscribe(t),c=()=>{const e=o();return s.useSyncExternalStore(n(e),()=>e.getSnapshot().ready,()=>!1)},a=()=>{const e=o();return s.useSyncExternalStore(n(e),()=>e.getSnapshot().error,()=>{})},i=()=>{const e=o();return s.useSyncExternalStore(n(e),()=>e.getSnapshot().cameraTexture,()=>{})},S=()=>{const e=o(),t=s.useSyncExternalStore(n(e),()=>e.getSnapshot().renderWidth,()=>0),r=s.useSyncExternalStore(n(e),()=>e.getSnapshot().renderHeight,()=>0);return s.useMemo(()=>({width:t,height:r}),[t,r])},l=e=>{const t=o(),r=s.useSyncExternalStore(n(t),()=>t.getSnapshot().pipeline.get(e)??null,()=>null);return s.useMemo(()=>r?r.getModelNode():null,[r])},p=()=>{const e=o(),t=s.useSyncExternalStore(n(e),()=>e.getSnapshot().pipeline,()=>e.getSnapshot().pipeline);return s.useMemo(()=>Array.from(t.keys()),[t])};exports.useXRCameraTexture=i;exports.useXRError=a;exports.useXRModelNode=l;exports.useXRPipelineSnapshot=p;exports.useXRReady=c;exports.useXRRenderSize=S;
+"use strict";const s=require("react"),u=require("./index-D4bLzBr6.cjs"),o=()=>u.useXRContext().session.store,n=e=>t=>e.subscribe(t),c=()=>{const e=o();return s.useSyncExternalStore(n(e),()=>e.getSnapshot().ready,()=>!1)},a=()=>{const e=o();return s.useSyncExternalStore(n(e),()=>e.getSnapshot().error,()=>{})},i=()=>{const e=o();return s.useSyncExternalStore(n(e),()=>e.getSnapshot().cameraTexture,()=>{})},S=()=>{const e=o(),t=s.useSyncExternalStore(n(e),()=>e.getSnapshot().renderWidth,()=>0),r=s.useSyncExternalStore(n(e),()=>e.getSnapshot().renderHeight,()=>0);return s.useMemo(()=>({width:t,height:r}),[t,r])},l=e=>{const t=o(),r=s.useSyncExternalStore(n(t),()=>t.getSnapshot().pipeline.get(e)??null,()=>null);return s.useMemo(()=>r?r.getModelNode():null,[r])},p=()=>{const e=o(),t=s.useSyncExternalStore(n(e),()=>e.getSnapshot().pipeline,()=>e.getSnapshot().pipeline);return s.useMemo(()=>Array.from(t.keys()),[t])};exports.useXRCameraTexture=i;exports.useXRError=a;exports.useXRModelNode=l;exports.useXRPipelineSnapshot=p;exports.useXRReady=c;exports.useXRRenderSize=S;

package/dist/{selectors-CXd_x-6t.js → selectors-Dw3C-gSk.js}

@@ -1,5 +1,5 @@
 import { useSyncExternalStore as s, useMemo as a } from "react";
-import { u } from "./index-safCs_af.js";
+import { u } from "./index-JygePOwo.js";
 const r = () => u().session.store, o = (e) => (t) => e.subscribe(t), p = () => {
   const e = r();
   return s(
@@ -52,8 +52,8 @@ const r = () => u().session.store, o = (e) => (t) => e.subscribe(t), p = () => {
 export {
   l as a,
   d as b,
-  h as c,
-  S as d,
+  S as c,
+  h as d,
   g as e,
   p as u
 };

package/dist/services/MetricsCollector/index.d.ts

@@ -1,5 +1,11 @@
 import { DebuggerMetrics } from '../../types/debugger';
 import { MetricsCollectorOptions } from './types';
+type PerformanceModel = {
+    getPerformanceData?: () => Promise<{
+        name: string;
+        processingTime?: number | null;
+    }>;
+};
 export declare class MetricsCollector {
     private options;
     private isRunning;
@@ -45,7 +51,7 @@ export declare class MetricsCollector {
      * Update detection time from models
      * Aggregates processing time from all active models in the XR pipeline
      */
-    updateDetectionTime(pipeline?: Partial<Record<string, any>>): Promise<void>;
+    updateDetectionTime(pipeline?: Partial<Record<string, PerformanceModel>>): Promise<void>;
     /**
      * Update effective FPS calculation
      * (will be implemented in Phase 6)

package/dist/services/MetricsCollector/utils.d.ts

@@ -45,7 +45,7 @@ export declare function smoothValue(currentValue: number, newValue: number, smoo
  * @param func Function to throttle
  * @param wait Minimum time between executions in milliseconds
  */
-export declare function throttle<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+export declare function throttle<T extends (...args: never[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
 /**
  * Format number to fixed decimal places
  * @param value Number to format

package/dist/session-BChR4TgK.cjs

@@ -0,0 +1,31 @@
+"use strict";const p=require("./index-D4bLzBr6.cjs"),n=require("react/jsx-runtime"),L=require("react-dom"),c=require("react"),d=require("./x-KC8E4Gaj.cjs"),v=(t,e)=>new URL(`/assets/sdk/debug-ui/v1/${t}/${e}`,p.libConfig.assetStorageEndpoint).href,j=t=>t.replace(/\.[^.]+$/,"").replace(/[_-]+/g," ").replace(/\s+/g," ").trim().replace(/\b\w/g,e=>e.toUpperCase()),$=["person_fullbody.mp4","person_looking.mp4","person_shaking_head.mp4","person_thumbUp.mp4","two_people_smiling.mp4"],z=["person_fist_sign.jpg","person_fullbody.jpg","person_peace_sign.jpg","person_portrait.jpg","person_side_portrait.jpg","three_people_smiling.jpg","two_people_smiling.jpg"],W=(t,e)=>({id:`sdk-video-${e+1}`,kind:"video",label:j(t),url:v("videos",t)}),F=(t,e)=>({id:`sdk-image-${e+1}`,kind:"image",label:j(t),url:v("images",t)}),M=$.map(W),_=z.map(F),V=[{id:"webcam",kind:"webcam",label:"Webcam"},...M,..._];/**
+ * @license lucide-react v1.17.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */const X=[["path",{d:"M13.997 4a2 2 0 0 1 1.76 1.05l.486.9A2 2 0 0 0 18.003 7H20a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V9a2 2 0 0 1 2-2h1.997a2 2 0 0 0 1.759-1.048l.489-.904A2 2 0 0 1 10.004 4z",key:"18u6gg"}],["circle",{cx:"12",cy:"13",r:"3",key:"1vg3eu"}]],P=d.createLucideIcon("camera",X);/**
+ * @license lucide-react v1.17.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */const T=[["path",{d:"m6 9 6 6 6-6",key:"qrunsl"}]],U=d.createLucideIcon("chevron-down",T);/**
+ * @license lucide-react v1.17.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */const q=[["circle",{cx:"9",cy:"12",r:"1",key:"1vctgf"}],["circle",{cx:"9",cy:"5",r:"1",key:"hp0tcf"}],["circle",{cx:"9",cy:"19",r:"1",key:"fkjjf6"}],["circle",{cx:"15",cy:"12",r:"1",key:"1tmaij"}],["circle",{cx:"15",cy:"5",r:"1",key:"19l28e"}],["circle",{cx:"15",cy:"19",r:"1",key:"f4zoj3"}]],D=d.createLucideIcon("grip-vertical",q);/**
+ * @license lucide-react v1.17.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */const N=[["rect",{width:"18",height:"18",x:"3",y:"3",rx:"2",ry:"2",key:"1m3agn"}],["circle",{cx:"9",cy:"9",r:"2",key:"af1f0g"}],["path",{d:"m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21",key:"1xmnt7"}]],A=d.createLucideIcon("image",N);/**
+ * @license lucide-react v1.17.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */const K=[["path",{d:"M4 5h16",key:"1tepv9"}],["path",{d:"M4 12h16",key:"1lakjw"}],["path",{d:"M4 19h16",key:"1djgab"}]],B=d.createLucideIcon("menu",K);/**
+ * @license lucide-react v1.17.0 - ISC
+ *
+ * This source code is licensed under the ISC license.
+ * See the LICENSE file in the root directory of this source tree.
+ */const O=[["path",{d:"m16 13 5.223 3.482a.5.5 0 0 0 .777-.416V7.87a.5.5 0 0 0-.752-.432L16 10.5",key:"ftymec"}],["rect",{x:"2",y:"6",width:"14",height:"12",rx:"2",key:"158x01"}]],H=d.createLucideIcon("video",O),G=t=>t==="webcam"?"📷 ":t==="image"?"🖼 ":"▶ ",Y={position:"fixed",zIndex:2e4,pointerEvents:"none"},I={pointerEvents:"auto",border:"1px solid rgba(255, 255, 255, 0.12)",background:"rgba(8, 15, 28, 0.58)",boxShadow:"0 12px 32px rgba(0, 0, 0, 0.28)",backdropFilter:"blur(20px) saturate(1.15)",WebkitBackdropFilter:"blur(20px) saturate(1.15)",color:"#f8fafc",display:"flex"},J={...I,width:34,height:34,borderRadius:17,alignItems:"center",justifyContent:"center",cursor:"pointer",transition:"transform 150ms ease"},Q={...I,flexDirection:"column",borderRadius:12,overflow:"hidden",padding:4,gap:4},Z={display:"flex",alignItems:"center",gap:3},ee={width:1,height:12,background:"rgba(255, 255, 255, 0.12)",margin:"0 3px"},te={display:"flex",width:16,height:24,alignItems:"center",justifyContent:"center",cursor:"grab",color:"rgba(148, 163, 184, 0.8)",flex:"0 0 auto"},k=(t=!1)=>({display:"flex",width:24,height:24,alignItems:"center",justifyContent:"center",borderRadius:8,border:`1px solid ${t?"rgba(255, 255, 255, 0.12)":"transparent"}`,background:t?"rgba(255, 255, 255, 0.08)":"transparent",color:t?"#f8fafc":"rgba(226, 232, 240, 0.72)",cursor:"pointer",flex:"0 0 auto",transition:"background 120ms ease, color 120ms ease"}),re={position:"relative",display:"flex",alignItems:"center"},ne={width:"100%",minWidth:140,height:24,borderRadius:8,border:"1px solid rgba(255, 255, 255, 0.10)",background:"rgba(15, 23, 42, 0.65)",color:"#f8fafc",fontSize:11,outline:"none",paddingLeft:7,paddingRight:20,appearance:"none",cursor:"pointer"},ie={pointerEvents:"none",position:"absolute",right:5,top:0,bottom:0,display:"flex",alignItems:"center",color:"rgba(148, 163, 184, 0.9)"},se={height:24,display:"flex",alignItems:"center",padding:"0 8px",borderRadius:8,border:"1px solid rgba(255, 255, 255, 0.08)",background:"rgba(255, 255, 255, 0.04)",color:"rgba(226, 232, 240, 0.72)",fontSize:11},S={width:14,height:14},oe=({value:t,onChange:e,sources:i,style:a})=>{const[l,m]=c.useState(!1),[o,y]=c.useState({x:16,y:16}),[u,f]=c.useState(t.kind),g=c.useRef(null),x=c.useMemo(()=>({webcam:i.filter(r=>r.kind==="webcam"),image:i.filter(r=>r.kind==="image"),video:i.filter(r=>r.kind==="video")}),[i]),b=x[u];c.useEffect(()=>{f(t.kind)},[t.kind]);const E=r=>{f(r);const s=x[r][0];s&&e(s)};c.useEffect(()=>{const r=h=>{g.current&&y({x:Math.max(8,h.clientX-g.current.x),y:Math.max(8,h.clientY-g.current.y)})},s=()=>{g.current=null,document.body.classList.remove("select-none")};return window.addEventListener("pointermove",r),window.addEventListener("pointerup",s),()=>{window.removeEventListener("pointermove",r),window.removeEventListener("pointerup",s)}},[]);const w=r=>{const s=r.currentTarget.getBoundingClientRect();g.current={x:r.clientX-s.left,y:r.clientY-s.top},document.body.classList.add("select-none"),r.currentTarget.setPointerCapture(r.pointerId)},C=()=>{if(b.length===0){const r=u==="webcam"?"No camera source":u==="image"?"No image preview":"No video preview";return n.jsx("div",{style:se,children:r})}return n.jsxs("div",{style:re,children:[n.jsx("select",{value:t.id,onChange:r=>{const s=i.find(h=>h.id===r.target.value);s&&e(s)},style:ne,children:b.map(r=>n.jsxs("option",{value:r.id,children:[G(u),r.label]},r.id))}),n.jsx("div",{style:ie,children:n.jsx("span",{style:{width:10,height:10},children:n.jsx(U,{size:10,strokeWidth:1.8})})})]})};return typeof document>"u"?null:L.createPortal(n.jsx("div",{style:{...Y,left:o.x,top:o.y,...a},children:l?n.jsxs("div",{style:Q,children:[n.jsxs("div",{style:Z,children:[n.jsx("div",{onPointerDown:w,style:te,title:"Drag to move",children:n.jsx(D,{size:11,strokeWidth:2})}),n.jsx("button",{type:"button",onClick:()=>m(!1),style:k(!1),title:"Close Menu",children:n.jsx("span",{style:S,children:n.jsx(d.X,{size:14,strokeWidth:1.8})})}),n.jsx("div",{style:ee}),["webcam","image","video"].map(r=>n.jsx("button",{type:"button",onClick:()=>E(r),style:k(u===r),title:r.charAt(0).toUpperCase()+r.slice(1),children:n.jsx("span",{style:S,children:r==="webcam"?n.jsx(P,{size:14,strokeWidth:1.8}):r==="image"?n.jsx(A,{size:14,strokeWidth:1.8}):n.jsx(H,{size:14,strokeWidth:1.8})})},r))]}),C()]}):n.jsx("div",{style:J,onClick:()=>m(!0),onPointerDown:w,title:"Open Media Menu",children:n.jsx("span",{style:{width:16,height:16},children:n.jsx(B,{size:14,strokeWidth:1.8})})})}),document.body)},ce=async t=>{const e=new Image;e.crossOrigin="anonymous",e.src=t,await e.decode();const i=document.createElement("canvas");i.width=e.naturalWidth,i.height=e.naturalHeight;const a=i.getContext("2d");if(!a)throw new Error("Unable to create image media canvas");return a.drawImage(e,0,0,i.width,i.height),i.captureStream(30)},ae=async t=>{const e=document.createElement("video");return e.src=t,e.loop=!0,e.muted=!0,e.playsInline=!0,e.crossOrigin="anonymous",await e.play(),e.captureStream()},R=(t,e)=>{const{session:i}=p.useXRContext();c.useEffect(()=>{let a=!1,l=null;return(async()=>{try{if(t.kind==="webcam")await i.setMediaSource({source:p.XRMediaSource.WEBCAM});else{if(!t.url)throw new Error(`Missing media URL for ${t.id}`);const o=t.kind==="image"?await ce(t.url):await ae(t.url);if(l=o,a){o.getTracks().forEach(y=>y.stop());return}await i.setMediaSource({source:p.XRMediaSource.STREAM,stream:o,sourceKind:t.kind})}await i.registerXRPipeline((e==null?void 0:e.pipeline)??[{model:p.XRModel.FACE_TRACKER,options:{numFaces:(e==null?void 0:e.numFaces)??1}}]),await i.start()}catch(o){console.error("[MediaSourceSession] Error initializing XR session:",o)}})(),()=>{a=!0,l==null||l.getTracks().forEach(o=>o.stop())}},[t,e==null?void 0:e.numFaces,e==null?void 0:e.pipeline,i])},de=R;exports.MediaSourceSwitcher=oe;exports.defaultMediaSources=V;exports.sdkImageMediaSources=_;exports.sdkVideoMediaSources=M;exports.useFaceTrackingMediaSourceSession=de;exports.useMediaSourceSession=R;