@vincentt-xr/sdk 2.0.0-alpha.7 → 2.0.0-alpha.9

package/dist/coordinates/feed.d.ts

@@ -0,0 +1,52 @@
+import { FeedPoint, FeedSourceKind, PixelSize, SourceOrientation, SourcePoint } from './spaces';
+/** A cover/contain fit of `source` into `destination`: scale and centred offset in destination pixels. */
+export type FitLayout = {
+    scale: number;
+    drawWidth: number;
+    drawHeight: number;
+    offsetX: number;
+    offsetY: number;
+};
+/**
+ * Scale and centred offset that fits `source` into `destination`. `cover`
+ * fills the destination and crops the excess; `contain` shows all of the
+ * source and letterboxes. `zoom` (> 1) enlarges the draw rect about the
+ * centre, cropping more of the edges — the session's `cameraZoom`.
+ */
+export declare const computeFitLayout: (source: PixelSize, destination: PixelSize, fit?: "cover" | "contain", zoom?: number) => FitLayout | null;
+/**
+ * How the session turns a source frame into the feed: cover-crop to the
+ * render size, framing `zoom`, and a horizontal mirror for the webcam.
+ * This is the one description of that transform; the blit loop, the
+ * segmentation mask fit and every point conversion derive from it.
+ */
+export type FeedCrop = FitLayout & {
+    source: PixelSize;
+    feed: PixelSize;
+    zoom: number;
+    mirrored: boolean;
+};
+/** The session mirrors the (front) webcam feed only; the rear camera, images and videos are drawn straight. An unknown kind is treated as the webcam. */
+export declare const isMirroredSourceKind: (kind: FeedSourceKind) => boolean;
+export declare const computeFeedCrop: ({ source, feed, zoom, mirrored, }: {
+    source: PixelSize;
+    feed: PixelSize;
+    zoom?: number;
+    mirrored?: boolean;
+}) => FeedCrop | null;
+/** Source pixel → feed normalized. Mirrors first (the session flips the frame before cropping). */
+export declare const sourceToFeed: (point: SourcePoint, crop: FeedCrop, target?: FeedPoint) => FeedPoint;
+/** Feed normalized → source pixel (the inverse of `sourceToFeed`; may fall outside the source when cropped). */
+export declare const feedToSource: (point: FeedPoint, crop: FeedCrop, target?: SourcePoint) => SourcePoint;
+/** True when a feed point lies inside the part of the source the crop kept. */
+export declare const isFeedPointInSource: (point: FeedPoint, crop: FeedCrop) => boolean;
+/** Flip a feed point horizontally (x → 1 − x). Positions in the feed never need this; use it for *direction* signs. */
+export declare const mirrorFeedX: <P extends FeedPoint>(point: P, target?: FeedPoint) => FeedPoint;
+/**
+ * Rotate a source pixel by the clockwise `orientation` the frame was given
+ * before use (a native capture delivered sideways). Returns the point in the
+ * rotated frame, whose size is `width`×`height` swapped for 90 / 270.
+ */
+export declare const orientSourcePoint: (point: SourcePoint, size: PixelSize, orientation: SourceOrientation, target?: SourcePoint) => SourcePoint;
+/** Size of a frame after `orientSourcePoint`'s rotation. */
+export declare const orientedSize: (size: PixelSize, orientation: SourceOrientation) => PixelSize;

package/dist/coordinates/index.d.ts

@@ -0,0 +1,7 @@
+export type { FeedPoint, FeedSourceKind, PixelSize, SourceOrientation, SourcePoint, ViewportPoint, } from './spaces';
+export { computeFeedCrop, computeFitLayout, feedToSource, isFeedPointInSource, isMirroredSourceKind, mirrorFeedX, orientSourcePoint, orientedSize, sourceToFeed, } from './feed';
+export type { FeedCrop, FitLayout } from './feed';
+export { feedSidedName, otherSide, personLeftSign, personSide, swapSidedName } from './side';
+export type { PersonSide } from './side';
+export { feedToWorld, trackerToWorld, worldToFeed, worldToTracker } from './world';
+export { feedToScreenPixels, feedToTracker, feedToViewport, screenPixelsToFeed, trackerToFeed, viewportToFeed, } from './viewport';

package/dist/coordinates/side.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Left and right (#298). Every SDK name with a side means the PERSON'S OWN
+ * side, on every source. MediaPipe names sides as the image shows them: its
+ * face mesh's "left" (landmark 263, the canonical head frame's +X), its pose
+ * "left" landmarks (11, 13, 15 …), its hand "Left" label and its `…Left`
+ * blendshapes all sit on the image's right for a person facing the camera.
+ * That is the person's own left on an unmirrored feed (rear camera, image,
+ * video) and their RIGHT on the mirrored front webcam, which the session
+ * mirrors before any model sees it. These helpers turn one into the other.
+ */
+/** A side of the person (or MediaPipe's name for one). */
+export type PersonSide = "left" | "right";
+/** The other side. */
+export declare const otherSide: (side: PersonSide) => PersonSide;
+/**
+ * MediaPipe's side (mesh, pose landmark, hand label, blendshape) → the
+ * person's own side on this feed. The map is its own inverse, so it also
+ * turns a person's side into the MediaPipe side to read on this feed.
+ * `feedMirrored` is the session's mirror state (`useXRMirrored()`; the front
+ * webcam is mirrored).
+ */
+export declare const personSide: (side: PersonSide, feedMirrored: boolean) => PersonSide;
+/**
+ * Swaps the first `left` / `right` (or `Left` / `Right`) in a sided name:
+ * `"face.leftCheek"` ↔ `"face.rightCheek"`, `"leftEarLobe"` ↔ `"rightEarLobe"`,
+ * `"nose.left"` ↔ `"nose.right"`. A name without a side is returned as it is.
+ */
+export declare const swapSidedName: <T extends string>(name: T) => T;
+/**
+ * The person-side name → the name MediaPipe gives that part on this feed
+ * (and back: the map is its own inverse). Unchanged on an unmirrored feed;
+ * left and right swapped on the mirrored webcam.
+ */
+export declare const feedSidedName: <T extends string>(name: T, feedMirrored: boolean) => T;
+/**
+ * The direction of the person's own left along the canonical head frame's X
+ * and the feed's x: `+1` on an unmirrored feed (the person's left is on the
+ * image's right, canonical +X), `−1` on the mirrored webcam.
+ */
+export declare const personLeftSign: (feedMirrored: boolean) => 1 | -1;

package/dist/coordinates/spaces.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The coordinate spaces a tracking consumer meets, named once.
+ *
+ *   source ──cover-crop + zoom (+ mirror for webcam)──▶ feed ◀──identity per axis──▶ viewport
+ *                                                       │                               │
+ *                                                       ▼                               ▼
+ *                                                    tracker                         screen (design px)
+ *                                                       │
+ *                                                       ▼ (camera, z = 0 plane)
+ *                                                     world
+ *
+ * - **source**: the raw media frame (webcam, video, image) in pixels; top-left
+ *   origin, Y down. Never mirrored.
+ * - **feed**: the session camera texture, i.e. the source cover-cropped to
+ *   the render size with `cameraZoom` and, for the webcam only, mirrored.
+ *   Normalized 0..1, top-left origin, Y down. Every landmark and every SDK
+ *   mask lives here; MediaPipe's `z` rides along as tracker-relative depth.
+ * - **tracker**: feed remapped to center origin, X right, Y up, Z toward the
+ *   viewer (`TrackerPoint`); what hand, body and holistic nodes publish.
+ * - **viewport**: the rendered canvas in CSS pixels, top-left, Y down. The
+ *   feed fills it exactly, so feed and viewport agree per axis.
+ * - **screen**: SDK design pixels (720×1280 by default), center origin, Y up.
+ * - **world**: three.js world space; tracked content sits on the z = 0 plane.
+ */
+/** Pixel size of a frame or surface. */
+export type PixelSize = {
+    width: number;
+    height: number;
+};
+/** Source-media pixels: top-left origin, Y down, never mirrored. */
+export type SourcePoint = {
+    x: number;
+    y: number;
+};
+/** Feed (camera texture) coordinates, normalized 0..1, top-left origin, Y down; `z` optional depth. */
+export type FeedPoint = {
+    x: number;
+    y: number;
+    z?: number;
+};
+/** Viewport pixels: top-left origin, Y down. */
+export type ViewportPoint = {
+    x: number;
+    y: number;
+};
+/** The session media kinds; `undefined` is treated as the webcam. Only `webcam` (and undefined) is mirrored. */
+export type FeedSourceKind = "webcam" | "rear-camera" | "image" | "video" | undefined;
+/** Clockwise rotation applied to a source frame before it is used, in degrees. */
+export type SourceOrientation = 0 | 90 | 180 | 270;

package/dist/coordinates/viewport.d.ts

@@ -0,0 +1,22 @@
+import { ScreenPixelPoint } from '../screen2d/coordinates';
+import { ScreenTransformRoot } from '../screen2d/screenTransform';
+import { TrackerPoint } from '../types/common';
+import { FeedPoint, PixelSize, ViewportPoint } from './spaces';
+/** Feed point → tracker point (center origin, Y up, Z toward the viewer). */
+export declare const feedToTracker: (point: FeedPoint, target?: TrackerPoint) => TrackerPoint;
+/** Tracker point → feed point. */
+export declare const trackerToFeed: (point: TrackerPoint, target?: FeedPoint) => FeedPoint;
+/** Feed point → viewport pixels. The feed fills the viewport, so this is a per-axis scale. */
+export declare const feedToViewport: (point: FeedPoint, viewport: PixelSize, target?: ViewportPoint) => ViewportPoint;
+/** Viewport pixels → feed point. */
+export declare const viewportToFeed: (point: ViewportPoint, viewport: PixelSize, target?: FeedPoint) => FeedPoint;
+/** Feed point → SDK design pixels (center origin, Y up). */
+export declare const feedToScreenPixels: (point: FeedPoint, viewport: PixelSize, options?: {
+    root?: ScreenTransformRoot;
+    target?: ScreenPixelPoint;
+}) => ScreenPixelPoint;
+/** SDK design pixels → feed point. */
+export declare const screenPixelsToFeed: (point: ScreenPixelPoint, viewport: PixelSize, options?: {
+    root?: ScreenTransformRoot;
+    target?: FeedPoint;
+}) => FeedPoint;

package/dist/coordinates/world.d.ts

@@ -0,0 +1,15 @@
+import { TrackerPoint } from '../types/common';
+import { FeedPoint } from './spaces';
+import * as THREE from "three";
+/**
+ * Feed point (0..1, top-left, Y down) → world position on the `z = planeZ`
+ * plane (default 0, the tracking plane). Depth (`z`) does not move the
+ * result: the ray through the pixel is the same at any depth.
+ */
+export declare const feedToWorld: (point: FeedPoint, camera: THREE.Camera, out?: THREE.Vector3, planeZ?: number) => THREE.Vector3;
+/** Tracker point (center origin, Y up) → world position on the `z = planeZ` plane. */
+export declare const trackerToWorld: (point: TrackerPoint, camera: THREE.Camera, out?: THREE.Vector3, planeZ?: number) => THREE.Vector3;
+/** World position → feed point (0..1, top-left, Y down); `z` carries the NDC depth. */
+export declare const worldToFeed: (point: THREE.Vector3Like, camera: THREE.Camera, target?: Required<FeedPoint>) => Required<FeedPoint>;
+/** World position → tracker point (center origin, Y up); `z` carries the NDC depth. */
+export declare const worldToTracker: (point: THREE.Vector3Like, camera: THREE.Camera, target?: TrackerPoint) => TrackerPoint;

package/dist/debug-ui/default-setting.cjs

@@ -13,9 +13,9 @@
  *
  * This source code is licensed under the ISC license.
  * See the LICENSE file in the root directory of this source tree.
- */const $=[["path",{d:"M12 22a1 1 0 0 1 0-20 10 9 0 0 1 10 9 5 5 0 0 1-5 5h-2.25a1.75 1.75 0 0 0-1.4 2.8l.3.4a1.75 1.75 0 0 1-1.4 2.8z",key:"e79jfc"}],["circle",{cx:"13.5",cy:"6.5",r:".5",fill:"currentColor",key:"1okk4w"}],["circle",{cx:"17.5",cy:"10.5",r:".5",fill:"currentColor",key:"f64h9f"}],["circle",{cx:"6.5",cy:"12.5",r:".5",fill:"currentColor",key:"qy21gx"}],["circle",{cx:"8.5",cy:"7.5",r:".5",fill:"currentColor",key:"fotxhn"}]],q=j.createLucideIcon("palette",$);/**
+ */const U=[["path",{d:"M12 22a1 1 0 0 1 0-20 10 9 0 0 1 10 9 5 5 0 0 1-5 5h-2.25a1.75 1.75 0 0 0-1.4 2.8l.3.4a1.75 1.75 0 0 1-1.4 2.8z",key:"e79jfc"}],["circle",{cx:"13.5",cy:"6.5",r:".5",fill:"currentColor",key:"1okk4w"}],["circle",{cx:"17.5",cy:"10.5",r:".5",fill:"currentColor",key:"f64h9f"}],["circle",{cx:"6.5",cy:"12.5",r:".5",fill:"currentColor",key:"qy21gx"}],["circle",{cx:"8.5",cy:"7.5",r:".5",fill:"currentColor",key:"fotxhn"}]],q=j.createLucideIcon("palette",U);/**
  * @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 U=[["path",{d:"M12 2v10",key:"mnfbl"}],["path",{d:"M18.4 6.6a9 9 0 1 1-12.77.04",key:"obofu9"}]],K=j.createLucideIcon("power",U),Y={transform:{enabled:!0,anchors:{left:-.5,right:.5,top:.2,bottom:-.2},offsets:{left:0,right:0,top:0,bottom:0},pivot:[0,0]},material:{enabled:!0,text:"Hello from Vincentt",fontSize:220,color:"#ffffff",bgColor:"#14286e",borderRadius:24,aspect:3,opacity:1,padding:32,borderWidth:0,borderColor:"transparent"},textLabel:{enabled:!0,position:[0,0,0],rotation:[0,0,0],scale:[1,1,1]}},G={position:"fixed",left:14,top:104,zIndex:2e4,pointerEvents:"none"},N={pointerEvents:"auto",width:298,borderRadius:16,border:"1px solid rgba(255,255,255,0.12)",background:"rgba(8, 15, 28, 0.58)",boxShadow:"0 16px 36px rgba(0,0,0,0.28)",backdropFilter:"blur(20px) saturate(1.1)",WebkitBackdropFilter:"blur(20px) saturate(1.1)",color:"#f8fafc",overflow:"hidden"},Z={...N,width:32,height:32,borderRadius:16,display:"flex",alignItems:"center",justifyContent:"center",cursor:"pointer"},H={display:"flex",width:14,height:14,alignItems:"center",justifyContent:"center",color:"#f8fafc"},J={display:"flex",alignItems:"center",gap:7,padding:"7px 8px",borderBottom:"1px solid rgba(255,255,255,0.08)"},Q={width:16,height:16,display:"flex",alignItems:"center",justifyContent:"center",cursor:"grab",color:"rgba(148,163,184,0.82)",flex:"0 0 auto"},ee={display:"flex",alignItems:"center",gap:6,fontSize:11,fontWeight:600,letterSpacing:.2,minWidth:0},z={display:"flex",width:18,height:18,alignItems:"center",justifyContent:"center",borderRadius:6,background:"rgba(255,255,255,0.08)",border:"1px solid rgba(255,255,255,0.08)",color:"#e2e8f0",flex:"0 0 auto"},te={display:"inline-flex",alignItems:"center",justifyContent:"center",height:24,padding:"0 8px 0 7px",borderRadius:8,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(255,255,255,0.05)",color:"#e2e8f0",fontSize:10,cursor:"pointer",gap:5},le={display:"inline-flex",alignItems:"center",justifyContent:"center",width:24,height:24,borderRadius:8,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(255,255,255,0.05)",color:"#e2e8f0",cursor:"pointer",padding:0,flex:"0 0 auto"},se={display:"flex",flexDirection:"column",gap:6,padding:7},ae={borderRadius:12,border:"1px solid rgba(255,255,255,0.08)",background:"rgba(255,255,255,0.03)",overflow:"hidden"},ie={display:"flex",alignItems:"center",gap:7,padding:"6px 7px"},oe={display:"flex",alignItems:"center",gap:6,fontSize:11,fontWeight:500,flex:"1 1 auto",minWidth:0},ne={width:28,height:16,borderRadius:999,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(255,255,255,0.08)",padding:2,display:"flex",alignItems:"center",cursor:"pointer",flex:"0 0 auto"},re=r=>({width:10,height:10,borderRadius:999,background:r?"#f8fafc":"rgba(148,163,184,0.7)",transform:r?"translateX(12px)":"translateX(0)",transition:"transform 140ms ease, background 140ms ease"}),de={display:"grid",gap:7,padding:"0 7px 7px"},I={display:"grid",gap:5},v={fontSize:9,color:"rgba(226,232,240,0.66)",letterSpacing:.4,textTransform:"uppercase"},S={display:"grid",gridTemplateColumns:"repeat(2, minmax(0, 1fr))",gap:6},i={display:"flex",flexDirection:"column",gap:4},o={fontSize:9,color:"rgba(226,232,240,0.72)",letterSpacing:.2},M={width:"100%",height:24,borderRadius:7,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(15,23,42,0.68)",color:"#f8fafc",fontSize:10.5,outline:"none",padding:"0 7px",boxSizing:"border-box"},C={width:"100%",height:24,borderRadius:7,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(15,23,42,0.68)",color:"#f8fafc",fontSize:10.5,outline:"none",padding:2,boxSizing:"border-box",cursor:"pointer"},ce={...M,fontVariantNumeric:"tabular-nums"},R={width:12,height:12,display:"flex"},D=()=>e.jsx(K,{size:12,strokeWidth:1.9}),xe=()=>e.jsx(q,{size:12,strokeWidth:1.9}),pe=()=>e.jsx(O,{size:12,strokeWidth:1.9}),be=()=>e.jsx("svg",{width:"11",height:"15",viewBox:"0 0 24 24",fill:"currentColor","aria-hidden":"true",children:e.jsx("path",{d:"M8 6a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM8 12a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM8 18a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM16 6a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM16 12a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM16 18a2 2 0 1 1-4 0 2 2 0 0 1 4 0z"})}),ye=r=>/^-?\d*(\.\d*)?$/.test(r),d=({value:r,onChange:h,step:x=1})=>{const[b,y]=g.useState(String(r));return g.useEffect(()=>{y(String(r))},[r]),e.jsx("input",{type:"text",inputMode:"decimal",pattern:"-?[0-9]*[.,]?[0-9]*",style:ce,value:b,onChange:n=>{const c=n.target.value;if(!ye(c)||(y(c),c===""||c==="-"||c==="."||c==="-."))return;const p=Number(c);Number.isNaN(p)||h(p)},onBlur:()=>{if(b===""||b==="-"||b==="."||b==="-."){y(String(r));return}const n=Number(b);if(Number.isNaN(n)){y(String(r));return}y(String(n)),n!==r&&h(n)},onKeyDown:n=>{if(n.key!=="ArrowUp"&&n.key!=="ArrowDown")return;n.preventDefault();const c=n.shiftKey?x*10:n.altKey?x/10:x,p=n.key==="ArrowUp"?r+c:r-c,u=Number.isInteger(p)?p:Number(p.toFixed(6));y(String(u)),h(u)}})},ge=({style:r,value:h,onChange:x,children:b})=>{const[y,n]=g.useState(!0),[c,p]=g.useState(!1),[u,T]=g.useState({x:14,y:104}),[W,E]=g.useState(Y),f=g.useRef(null),s=h??W,a=l=>{const t=l(s);h||E(t),x==null||x(t)};g.useEffect(()=>{const l=m=>{f.current&&T({x:Math.max(8,m.clientX-f.current.x),y:Math.max(8,m.clientY-f.current.y)})},t=()=>{f.current=null,document.body.classList.remove("select-none")};return window.addEventListener("pointermove",l),window.addEventListener("pointerup",t),()=>{window.removeEventListener("pointermove",l),window.removeEventListener("pointerup",t)}},[]);const P=async()=>{await navigator.clipboard.writeText(JSON.stringify(s,null,2)),p(!0),window.setTimeout(()=>p(!1),1200)},B=l=>{const t=l.currentTarget.getBoundingClientRect();f.current={x:l.clientX-t.left,y:l.clientY-t.top},document.body.classList.add("select-none"),l.currentTarget.setPointerCapture(l.pointerId)},w=(l,t,m,_,k)=>e.jsxs("div",{style:ae,children:[e.jsxs("div",{style:ie,children:[e.jsx("button",{type:"button",onClick:()=>a(L=>({...L,[l]:{...L[l],enabled:!L[l].enabled}})),style:ne,"aria-label":`Toggle ${t}`,children:e.jsx("div",{style:re(k)})}),e.jsxs("div",{style:oe,children:[e.jsx("span",{style:z,children:m}),e.jsx("span",{children:t})]})]}),k?e.jsx("div",{style:de,children:_}):null]},l);return typeof document>"u"?null:V.createPortal(e.jsx("div",{style:{...G,left:u.x,top:u.y,...r},children:y?e.jsxs("div",{style:N,children:[e.jsxs("div",{style:J,children:[e.jsx("div",{onPointerDown:B,style:Q,title:"Drag to move",children:e.jsx(be,{})}),e.jsxs("div",{style:ee,children:[e.jsx("span",{style:z,children:e.jsx(D,{})}),e.jsx("span",{children:"Default Setting"})]}),e.jsx("div",{style:{flex:"1 1 auto"}}),e.jsxs("button",{type:"button",onClick:P,style:te,title:"Copy config",children:[e.jsx("span",{style:R,children:e.jsx(pe,{})}),c?"Copied":"Copy"]}),e.jsx("button",{type:"button",onClick:()=>n(!1),style:le,title:"Collapse","aria-label":"Collapse Default Setting",children:e.jsx("span",{style:R,children:e.jsx(j.X,{size:12,strokeWidth:1.9})})})]}),e.jsx("div",{style:se,children:b??e.jsxs(e.Fragment,{children:[w("material","Material",e.jsx(xe,{}),e.jsx("div",{style:I,children:e.jsxs("div",{style:S,children:[e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Text"}),e.jsx("input",{style:M,value:s.material.text,onChange:l=>a(t=>({...t,material:{...t.material,text:l.target.value}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Font Size (1)"}),e.jsx(d,{value:s.material.fontSize,onChange:l=>a(t=>({...t,material:{...t.material,fontSize:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Color"}),e.jsx("input",{type:"color",style:C,value:s.material.color,onChange:l=>a(t=>({...t,material:{...t.material,color:l.target.value}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"BG"}),e.jsx("input",{type:"color",style:C,value:s.material.bgColor,onChange:l=>a(t=>({...t,material:{...t.material,bgColor:l.target.value}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Radius (1)"}),e.jsx(d,{value:s.material.borderRadius,onChange:l=>a(t=>({...t,material:{...t.material,borderRadius:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Aspect (1)"}),e.jsx(d,{value:s.material.aspect,onChange:l=>a(t=>({...t,material:{...t.material,aspect:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Padding (1)"}),e.jsx(d,{value:s.material.padding,onChange:l=>a(t=>({...t,material:{...t.material,padding:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Opacity"}),e.jsx(d,{value:s.material.opacity,onChange:l=>a(t=>({...t,material:{...t.material,opacity:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Border"}),e.jsx("input",{type:"color",style:C,value:s.material.borderColor,onChange:l=>a(t=>({...t,material:{...t.material,borderColor:l.target.value}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Border W (1)"}),e.jsx(d,{value:s.material.borderWidth,onChange:l=>a(t=>({...t,material:{...t.material,borderWidth:l}}))})]})]})}),s.material.enabled),w("textLabel","TextLabel",e.jsx(D,{}),e.jsxs("div",{style:I,children:[e.jsx("div",{style:v,children:"Position (0.1)"}),e.jsxs("div",{style:S,children:[e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"X (0.1)"}),e.jsx(d,{value:s.textLabel.position[0],step:.1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,position:[l,t.textLabel.position[1],t.textLabel.position[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Y (0.1)"}),e.jsx(d,{value:s.textLabel.position[1],step:.1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,position:[t.textLabel.position[0],l,t.textLabel.position[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Z (0.1)"}),e.jsx(d,{value:s.textLabel.position[2],step:.1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,position:[t.textLabel.position[0],t.textLabel.position[1],l]}}))})]})]}),e.jsx("div",{style:v,children:"Rotation (deg)"}),e.jsxs("div",{style:S,children:[e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"X (deg)"}),e.jsx(d,{value:s.textLabel.rotation[0],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,rotation:[l,t.textLabel.rotation[1],t.textLabel.rotation[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Y (deg)"}),e.jsx(d,{value:s.textLabel.rotation[1],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,rotation:[t.textLabel.rotation[0],l,t.textLabel.rotation[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Z (deg)"}),e.jsx(d,{value:s.textLabel.rotation[2],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,rotation:[t.textLabel.rotation[0],t.textLabel.rotation[1],l]}}))})]})]}),e.jsx("div",{style:v,children:"Scale (1)"}),e.jsxs("div",{style:S,children:[e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"X (1)"}),e.jsx(d,{value:s.textLabel.scale[0],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,scale:[l,t.textLabel.scale[1],t.textLabel.scale[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Y (1)"}),e.jsx(d,{value:s.textLabel.scale[1],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,scale:[t.textLabel.scale[0],l,t.textLabel.scale[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Z (1)"}),e.jsx(d,{value:s.textLabel.scale[2],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,scale:[t.textLabel.scale[0],t.textLabel.scale[1],l]}}))})]})]})]}),s.textLabel.enabled)]})})]}):e.jsx("div",{role:"button",tabIndex:0,onClick:()=>n(!0),onKeyDown:l=>{(l.key==="Enter"||l.key===" ")&&(l.preventDefault(),n(!0))},style:Z,title:"Open Default Setting","aria-label":"Open Default Setting",children:e.jsx("span",{style:H,children:e.jsx(A,{size:14,strokeWidth:1.8})})})}),document.body)};exports.DefaultSettingPanel=ge;
+ */const K=[["path",{d:"M12 2v10",key:"mnfbl"}],["path",{d:"M18.4 6.6a9 9 0 1 1-12.77.04",key:"obofu9"}]],Y=j.createLucideIcon("power",K),$={transform:{enabled:!0,anchors:{left:-.5,right:.5,top:.2,bottom:-.2},offsets:{left:0,right:0,top:0,bottom:0},pivot:[0,0]},material:{enabled:!0,text:"Hello from Vincentt",fontSize:220,color:"#ffffff",bgColor:"#14286e",borderRadius:24,aspect:3,opacity:1,padding:32,borderWidth:0,borderColor:"transparent"},textLabel:{enabled:!0,position:[0,0,0],rotation:[0,0,0],scale:[1,1,1]}},G={position:"fixed",left:14,top:104,zIndex:2e4,pointerEvents:"none"},N={pointerEvents:"auto",width:298,borderRadius:16,border:"1px solid rgba(255,255,255,0.12)",background:"rgba(8, 15, 28, 0.58)",boxShadow:"0 16px 36px rgba(0,0,0,0.28)",backdropFilter:"blur(20px) saturate(1.1)",WebkitBackdropFilter:"blur(20px) saturate(1.1)",color:"#f8fafc",overflow:"hidden"},Z={...N,width:32,height:32,borderRadius:16,display:"flex",alignItems:"center",justifyContent:"center",cursor:"pointer"},H={display:"flex",width:14,height:14,alignItems:"center",justifyContent:"center",color:"#f8fafc"},J={display:"flex",alignItems:"center",gap:7,padding:"7px 8px",borderBottom:"1px solid rgba(255,255,255,0.08)"},Q={width:16,height:16,display:"flex",alignItems:"center",justifyContent:"center",cursor:"grab",color:"rgba(148,163,184,0.82)",flex:"0 0 auto"},ee={display:"flex",alignItems:"center",gap:6,fontSize:11,fontWeight:600,letterSpacing:.2,minWidth:0},z={display:"flex",width:18,height:18,alignItems:"center",justifyContent:"center",borderRadius:6,background:"rgba(255,255,255,0.08)",border:"1px solid rgba(255,255,255,0.08)",color:"#e2e8f0",flex:"0 0 auto"},te={display:"inline-flex",alignItems:"center",justifyContent:"center",height:24,padding:"0 8px 0 7px",borderRadius:8,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(255,255,255,0.05)",color:"#e2e8f0",fontSize:10,cursor:"pointer",gap:5},le={display:"inline-flex",alignItems:"center",justifyContent:"center",width:24,height:24,borderRadius:8,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(255,255,255,0.05)",color:"#e2e8f0",cursor:"pointer",padding:0,flex:"0 0 auto"},se={display:"flex",flexDirection:"column",gap:6,padding:7},ae={borderRadius:12,border:"1px solid rgba(255,255,255,0.08)",background:"rgba(255,255,255,0.03)",overflow:"hidden"},ie={display:"flex",alignItems:"center",gap:7,padding:"6px 7px"},oe={display:"flex",alignItems:"center",gap:6,fontSize:11,fontWeight:500,flex:"1 1 auto",minWidth:0},ne={width:28,height:16,borderRadius:999,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(255,255,255,0.08)",padding:2,display:"flex",alignItems:"center",cursor:"pointer",flex:"0 0 auto"},re=r=>({width:10,height:10,borderRadius:999,background:r?"#f8fafc":"rgba(148,163,184,0.7)",transform:r?"translateX(12px)":"translateX(0)",transition:"transform 140ms ease, background 140ms ease"}),de={display:"grid",gap:7,padding:"0 7px 7px"},I={display:"grid",gap:5},v={fontSize:9,color:"rgba(226,232,240,0.66)",letterSpacing:.4,textTransform:"uppercase"},S={display:"grid",gridTemplateColumns:"repeat(2, minmax(0, 1fr))",gap:6},i={display:"flex",flexDirection:"column",gap:4},o={fontSize:9,color:"rgba(226,232,240,0.72)",letterSpacing:.2},M={width:"100%",height:24,borderRadius:7,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(15,23,42,0.68)",color:"#f8fafc",fontSize:10.5,outline:"none",padding:"0 7px",boxSizing:"border-box"},C={width:"100%",height:24,borderRadius:7,border:"1px solid rgba(255,255,255,0.10)",background:"rgba(15,23,42,0.68)",color:"#f8fafc",fontSize:10.5,outline:"none",padding:2,boxSizing:"border-box",cursor:"pointer"},ce={...M,fontVariantNumeric:"tabular-nums"},R={width:12,height:12,display:"flex"},D=()=>e.jsx(Y,{size:12,strokeWidth:1.9}),xe=()=>e.jsx(q,{size:12,strokeWidth:1.9}),pe=()=>e.jsx(O,{size:12,strokeWidth:1.9}),be=()=>e.jsx("svg",{width:"11",height:"15",viewBox:"0 0 24 24",fill:"currentColor","aria-hidden":"true",children:e.jsx("path",{d:"M8 6a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM8 12a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM8 18a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM16 6a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM16 12a2 2 0 1 1-4 0 2 2 0 0 1 4 0zM16 18a2 2 0 1 1-4 0 2 2 0 0 1 4 0z"})}),ye=r=>/^-?\d*(\.\d*)?$/.test(r),d=({value:r,onChange:h,step:x=1})=>{const[b,y]=g.useState(String(r));return g.useEffect(()=>{y(String(r))},[r]),e.jsx("input",{type:"text",inputMode:"decimal",pattern:"-?[0-9]*[.,]?[0-9]*",style:ce,value:b,onChange:n=>{const c=n.target.value;if(!ye(c)||(y(c),c===""||c==="-"||c==="."||c==="-."))return;const p=Number(c);Number.isNaN(p)||h(p)},onBlur:()=>{if(b===""||b==="-"||b==="."||b==="-."){y(String(r));return}const n=Number(b);if(Number.isNaN(n)){y(String(r));return}y(String(n)),n!==r&&h(n)},onKeyDown:n=>{if(n.key!=="ArrowUp"&&n.key!=="ArrowDown")return;n.preventDefault();const c=n.shiftKey?x*10:n.altKey?x/10:x,p=n.key==="ArrowUp"?r+c:r-c,u=Number.isInteger(p)?p:Number(p.toFixed(6));y(String(u)),h(u)}})},ge=({style:r,value:h,onChange:x,children:b})=>{const[y,n]=g.useState(!0),[c,p]=g.useState(!1),[u,T]=g.useState({x:14,y:104}),[W,E]=g.useState($),f=g.useRef(null),s=h??W,a=l=>{const t=l(s);h||E(t),x==null||x(t)};g.useEffect(()=>{const l=m=>{f.current&&T({x:Math.max(8,m.clientX-f.current.x),y:Math.max(8,m.clientY-f.current.y)})},t=()=>{f.current=null,document.body.classList.remove("select-none")};return window.addEventListener("pointermove",l),window.addEventListener("pointerup",t),()=>{window.removeEventListener("pointermove",l),window.removeEventListener("pointerup",t)}},[]);const P=async()=>{await navigator.clipboard.writeText(JSON.stringify(s,null,2)),p(!0),window.setTimeout(()=>p(!1),1200)},B=l=>{const t=l.currentTarget.getBoundingClientRect();f.current={x:l.clientX-t.left,y:l.clientY-t.top},document.body.classList.add("select-none"),l.currentTarget.setPointerCapture(l.pointerId)},w=(l,t,m,_,k)=>e.jsxs("div",{style:ae,children:[e.jsxs("div",{style:ie,children:[e.jsx("button",{type:"button",onClick:()=>a(L=>({...L,[l]:{...L[l],enabled:!L[l].enabled}})),style:ne,"aria-label":`Toggle ${t}`,children:e.jsx("div",{style:re(k)})}),e.jsxs("div",{style:oe,children:[e.jsx("span",{style:z,children:m}),e.jsx("span",{children:t})]})]}),k?e.jsx("div",{style:de,children:_}):null]},l);return typeof document>"u"?null:V.createPortal(e.jsx("div",{style:{...G,left:u.x,top:u.y,...r},children:y?e.jsxs("div",{style:N,children:[e.jsxs("div",{style:J,children:[e.jsx("div",{onPointerDown:B,style:Q,title:"Drag to move",children:e.jsx(be,{})}),e.jsxs("div",{style:ee,children:[e.jsx("span",{style:z,children:e.jsx(D,{})}),e.jsx("span",{children:"Default Setting"})]}),e.jsx("div",{style:{flex:"1 1 auto"}}),e.jsxs("button",{type:"button",onClick:P,style:te,title:"Copy config",children:[e.jsx("span",{style:R,children:e.jsx(pe,{})}),c?"Copied":"Copy"]}),e.jsx("button",{type:"button",onClick:()=>n(!1),style:le,title:"Collapse","aria-label":"Collapse Default Setting",children:e.jsx("span",{style:R,children:e.jsx(j.X,{size:12,strokeWidth:1.9})})})]}),e.jsx("div",{style:se,children:b??e.jsxs(e.Fragment,{children:[w("material","Material",e.jsx(xe,{}),e.jsx("div",{style:I,children:e.jsxs("div",{style:S,children:[e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Text"}),e.jsx("input",{style:M,value:s.material.text,onChange:l=>a(t=>({...t,material:{...t.material,text:l.target.value}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Font Size (1)"}),e.jsx(d,{value:s.material.fontSize,onChange:l=>a(t=>({...t,material:{...t.material,fontSize:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Color"}),e.jsx("input",{type:"color",style:C,value:s.material.color,onChange:l=>a(t=>({...t,material:{...t.material,color:l.target.value}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"BG"}),e.jsx("input",{type:"color",style:C,value:s.material.bgColor,onChange:l=>a(t=>({...t,material:{...t.material,bgColor:l.target.value}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Radius (1)"}),e.jsx(d,{value:s.material.borderRadius,onChange:l=>a(t=>({...t,material:{...t.material,borderRadius:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Aspect (1)"}),e.jsx(d,{value:s.material.aspect,onChange:l=>a(t=>({...t,material:{...t.material,aspect:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Padding (1)"}),e.jsx(d,{value:s.material.padding,onChange:l=>a(t=>({...t,material:{...t.material,padding:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Opacity"}),e.jsx(d,{value:s.material.opacity,onChange:l=>a(t=>({...t,material:{...t.material,opacity:l}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Border"}),e.jsx("input",{type:"color",style:C,value:s.material.borderColor,onChange:l=>a(t=>({...t,material:{...t.material,borderColor:l.target.value}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Border W (1)"}),e.jsx(d,{value:s.material.borderWidth,onChange:l=>a(t=>({...t,material:{...t.material,borderWidth:l}}))})]})]})}),s.material.enabled),w("textLabel","TextLabel",e.jsx(D,{}),e.jsxs("div",{style:I,children:[e.jsx("div",{style:v,children:"Position (0.1)"}),e.jsxs("div",{style:S,children:[e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"X (0.1)"}),e.jsx(d,{value:s.textLabel.position[0],step:.1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,position:[l,t.textLabel.position[1],t.textLabel.position[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Y (0.1)"}),e.jsx(d,{value:s.textLabel.position[1],step:.1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,position:[t.textLabel.position[0],l,t.textLabel.position[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Z (0.1)"}),e.jsx(d,{value:s.textLabel.position[2],step:.1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,position:[t.textLabel.position[0],t.textLabel.position[1],l]}}))})]})]}),e.jsx("div",{style:v,children:"Rotation (deg)"}),e.jsxs("div",{style:S,children:[e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"X (deg)"}),e.jsx(d,{value:s.textLabel.rotation[0],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,rotation:[l,t.textLabel.rotation[1],t.textLabel.rotation[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Y (deg)"}),e.jsx(d,{value:s.textLabel.rotation[1],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,rotation:[t.textLabel.rotation[0],l,t.textLabel.rotation[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Z (deg)"}),e.jsx(d,{value:s.textLabel.rotation[2],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,rotation:[t.textLabel.rotation[0],t.textLabel.rotation[1],l]}}))})]})]}),e.jsx("div",{style:v,children:"Scale (1)"}),e.jsxs("div",{style:S,children:[e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"X (1)"}),e.jsx(d,{value:s.textLabel.scale[0],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,scale:[l,t.textLabel.scale[1],t.textLabel.scale[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Y (1)"}),e.jsx(d,{value:s.textLabel.scale[1],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,scale:[t.textLabel.scale[0],l,t.textLabel.scale[2]]}}))})]}),e.jsxs("label",{style:i,children:[e.jsx("span",{style:o,children:"Z (1)"}),e.jsx(d,{value:s.textLabel.scale[2],step:1,onChange:l=>a(t=>({...t,textLabel:{...t.textLabel,scale:[t.textLabel.scale[0],t.textLabel.scale[1],l]}}))})]})]})]}),s.textLabel.enabled)]})})]}):e.jsx("div",{role:"button",tabIndex:0,onClick:()=>n(!0),onKeyDown:l=>{(l.key==="Enter"||l.key===" ")&&(l.preventDefault(),n(!0))},style:Z,title:"Open Default Setting","aria-label":"Open Default Setting",children:e.jsx("span",{style:H,children:e.jsx(A,{size:14,strokeWidth:1.8})})})}),document.body)};exports.DefaultSettingPanel=ge;

package/dist/debug-ui/face-swap-settings/index.d.ts

@@ -0,0 +1,22 @@
+import { FaceSwapSettings, FaceSwapSourceLike } from '../../components/FaceSwap/settings';
+export type FaceSwapSettingsPanelProps = {
+    title?: string;
+    value: Partial<FaceSwapSettings>;
+    onChange: (next: FaceSwapSettings) => void;
+    /**
+     * The swap's source, for the preset it starts from when `value` names
+     * none (painted faces start from `keepColors`). Default: `natural`.
+     */
+    source?: FaceSwapSourceLike | null;
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+};
+/**
+ * Live controls for `<FaceSwap>`: the preset, colour matching, edges, the
+ * kept eyes and mouth, detail, smoothing and amount. Choosing a preset
+ * applies it; editing a field it sets makes it `"custom"`. Spread the
+ * emitted settings onto `<FaceSwap>`.
+ */
+export declare const FaceSwapSettingsPanel: ({ title, value, onChange, source, initialPosition, }: FaceSwapSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/gesture-settings/index.d.ts

@@ -0,0 +1,14 @@
+import { GestureSettings } from '../../gestures/settings';
+export type GestureSettingsPanelProps = {
+    title?: string;
+    value: Partial<GestureSettings>;
+    /** The gesture's own defaults, so untouched fields show what it really uses. */
+    defaults?: GestureSettings;
+    onChange: (next: GestureSettings) => void;
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+};
+/** Live detector controls for one gesture; spread the emitted settings into `useGesture` options. */
+export declare const GestureSettingsPanel: ({ title, value, defaults, onChange, initialPosition, }: GestureSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/hierarchy-panel/index.d.ts

@@ -1,6 +1,7 @@
 import { RenderGroup, RenderGroupId } from '../../render/renderGroups';
 import { SceneObject, SceneObjectId, SceneObjectStore } from '../../scene-object';
-export type HierarchyPanelProps = {
+import { DebugWindowPlacementProps } from '../shared/debugWindow';
+export type HierarchyPanelProps = DebugWindowPlacementProps & {
     groups: RenderGroup[];
     objects: Record<SceneObjectId, SceneObject>;
     selectedObjectId?: SceneObjectId;
@@ -26,4 +27,4 @@ export type HierarchyPanelCopyConfig = {
     objects: Record<SceneObjectId, SceneObject>;
     components: SceneObjectStore["components"];
 };
-export declare const HierarchyPanel: ({ groups, objects, selectedObjectId, onSelectObject, onReorderGroup, onReorderObject, onMoveObject, onSetObjectParent, onToggleGroupEnabled, onToggleObjectVisible, copyConfig, initialPosition, title, }: HierarchyPanelProps) => import('react').ReactPortal | null;
+export declare const HierarchyPanel: ({ groups, objects, selectedObjectId, onSelectObject, onReorderGroup, onReorderObject, onMoveObject, onSetObjectParent, onToggleGroupEnabled, onToggleObjectVisible, copyConfig, docked, initialPosition, title, }: HierarchyPanelProps) => import('react').ReactNode;

package/dist/debug-ui/holistic-tracker-settings/index.d.ts

@@ -0,0 +1,16 @@
+import { HolisticTrackerSettings } from '../../components/HolisticTracker';
+export type HolisticTrackerSettingsPanelProps = {
+    title?: string;
+    value: Partial<HolisticTrackerSettings>;
+    onChange: (next: HolisticTrackerSettings) => void;
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+};
+/**
+ * Live controls for `<HolisticTracker>`; map the emitted settings onto the
+ * component with `toHolisticTrackerProps`. Hands, hold/predict and the
+ * analysis size apply without re-initializing; blendshapes and FPS re-acquire.
+ */
+export declare const HolisticTrackerSettingsPanel: ({ title, value, onChange, initialPosition, }: HolisticTrackerSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/index.d.ts

@@ -1,5 +1,6 @@
+export type { DebugWindowPlacementProps } from './shared/debugWindow';
 export { defaultMediaSources, sdkImageMediaSources, sdkVideoMediaSources } from './media-source';
-export type { MediaSourcePreset, MediaSourceSessionPipeline, MediaSourceSwitcherProps, UseMediaSourceSessionOptions, } from './media-source';
+export type { MediaSourcePlayback, MediaSourcePreset, MediaSourceSessionPipeline, MediaSourceSwitcherProps, UseMediaSourceSessionOptions, } from './media-source';
 export { MediaSourceSwitcher, useFaceTrackingMediaSourceSession, useMediaSourceSession, } from './media-source';
 export type { DefaultSettingPanelProps } from './default-setting';
 export { DefaultSettingPanel } from './default-setting';
@@ -29,10 +30,24 @@ export { PinToMeshSettingsPanel } from './pin-to-mesh-settings';
 export type { PinToMeshSettingsPanelProps } from './pin-to-mesh-settings';
 export type { SettingsPanelField, SettingsPanelOption, SettingsPanelProps, SettingsPanelValue, } from './settings-panel';
 export { SettingsPanel } from './settings-panel';
-export type { FaceWarp3DSettingsPanelProps } from './face-warp-3d';
-export { FaceWarp3DSettingsPanel } from './face-warp-3d';
 export type { FaceRetouchSettingsPanelProps } from './face-retouch';
 export { FaceRetouchSettingsPanel } from './face-retouch';
+export type { FaceSwapSettingsPanelProps } from './face-swap-settings';
+export { FaceSwapSettingsPanel } from './face-swap-settings';
+export type { GestureSettingsPanelProps } from './gesture-settings';
+export { GestureSettingsPanel } from './gesture-settings';
+export type { IrisEffectSettingsPanelProps } from './iris-effect-settings';
+export { IrisEffectSettingsPanel } from './iris-effect-settings';
+export type { LipEffectSettingsPanelProps } from './lip-effect-settings';
+export { LipEffectSettingsPanel } from './lip-effect-settings';
+export type { ProductHotspotPanelProps } from './product-hotspots';
+export { ProductHotspotPanel } from './product-hotspots';
+export type { XRDiagnosticsPanelProps } from './xr-diagnostics';
+export { XRDiagnosticsPanel } from './xr-diagnostics';
+export type { HolisticTrackerSettingsPanelProps } from './holistic-tracker-settings';
+export { HolisticTrackerSettingsPanel } from './holistic-tracker-settings';
+export type { SegmentationOverlaySettingsPanelProps } from './segmentation-overlay-settings';
+export { SegmentationOverlaySettingsPanel } from './segmentation-overlay-settings';
 export type { Transform3DSettingsPanelProps } from './transform-3d-settings';
 export { Transform3DSettingsPanel, Transform3DSettingsSection } from './transform-3d-settings';
 export type { MeshRendererSettingsPanelProps } from './mesh-renderer-settings';

package/dist/debug-ui/iris-effect-settings/index.d.ts

@@ -0,0 +1,12 @@
+import { IrisEffectSettings } from '../../components/IrisEffect';
+export type IrisEffectSettingsPanelProps = {
+    title?: string;
+    value: Partial<IrisEffectSettings>;
+    onChange: (next: IrisEffectSettings) => void;
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+};
+/** Live controls for `<IrisEffect>`; spread the emitted settings onto the component. */
+export declare const IrisEffectSettingsPanel: ({ title, value, onChange, initialPosition, }: IrisEffectSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/lip-effect-settings/index.d.ts

@@ -0,0 +1,15 @@
+import { LipEffectSettings } from '../../components/LipEffect';
+export type LipEffectSettingsPanelProps = {
+    title?: string;
+    value: Partial<LipEffectSettings>;
+    onChange: (next: LipEffectSettings) => void;
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+};
+/**
+ * Live controls for `LipEffect`: presets, mask mode, material and texture
+ * transform. Spread the emitted settings onto `<LipEffect>`.
+ */
+export declare const LipEffectSettingsPanel: ({ title, value, onChange, initialPosition, }: LipEffectSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/media-source/index.d.ts

@@ -3,4 +3,4 @@ export type { MediaSourcePreset } from './media-preset';
 export { MediaSourceSwitcher } from './MediaSourceSwitcher';
 export type { MediaSourceSwitcherProps } from './MediaSourceSwitcher';
 export { useFaceTrackingMediaSourceSession, useMediaSourceSession } from './session';
-export type { MediaSourceSessionPipeline, UseMediaSourceSessionOptions } from './session';
+export type { MediaSourcePlayback, MediaSourceSessionPipeline, UseMediaSourceSessionOptions, } from './session';

package/dist/debug-ui/media-source/session.d.ts

@@ -8,5 +8,33 @@ export type UseMediaSourceSessionOptions = {
     numFaces?: number;
     pipeline?: MediaSourceSessionPipeline[];
 };
-export declare const useMediaSourceSession: (mediaSource: MediaSourcePreset, options?: UseMediaSourceSessionOptions) => void;
-export declare const useFaceTrackingMediaSourceSession: (mediaSource: MediaSourcePreset, options?: UseMediaSourceSessionOptions) => void;
+/**
+ * Playback of the video clip a debug media session plays (the webcam and the
+ * stills have none). Tracking keeps running while the clip is paused: the
+ * session sees one still frame.
+ */
+export type MediaSourcePlayback = {
+    /** Whether the clip is paused. */
+    paused: boolean;
+    /** The clip's current time, seconds (updated a few times a second while playing). */
+    time: number;
+    /** The clip's length, seconds. */
+    duration: number;
+    /** Playback speed (`1` = normal). */
+    rate: number;
+    pause: () => void;
+    play: () => void;
+    /** Back to the start (keeps playing or paused as it was). */
+    restart: () => void;
+    /** Pauses and moves by `frames` (about 1/30 s each; negative = back). Default 1. */
+    step: (frames?: number) => void;
+    /** Playback speed, e.g. `0.25`, `0.5`, `1`. */
+    setRate: (rate: number) => void;
+};
+/**
+ * Binds a debug media preset (webcam, hosted clip or still) to the current XR
+ * session and starts its pipeline. Returns the clip's playback controls for a
+ * video (`null` for the webcam and stills, and until the clip is bound).
+ */
+export declare const useMediaSourceSession: (mediaSource: MediaSourcePreset, options?: UseMediaSourceSessionOptions) => MediaSourcePlayback | null;
+export declare const useFaceTrackingMediaSourceSession: (mediaSource: MediaSourcePreset, options?: UseMediaSourceSessionOptions) => MediaSourcePlayback | null;

package/dist/debug-ui/media-source.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../session-CpkiK5YA.cjs");exports.MediaSourceSwitcher=e.MediaSourceSwitcher;exports.defaultMediaSources=e.defaultMediaSources;exports.sdkImageMediaSources=e.sdkImageMediaSources;exports.sdkVideoMediaSources=e.sdkVideoMediaSources;exports.useFaceTrackingMediaSourceSession=e.useFaceTrackingMediaSourceSession;exports.useMediaSourceSession=e.useMediaSourceSession;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../session-BrH8G7iJ.cjs");exports.MediaSourceSwitcher=e.MediaSourceSwitcher;exports.defaultMediaSources=e.defaultMediaSources;exports.sdkImageMediaSources=e.sdkImageMediaSources;exports.sdkVideoMediaSources=e.sdkVideoMediaSources;exports.useFaceTrackingMediaSourceSession=e.useFaceTrackingMediaSourceSession;exports.useMediaSourceSession=e.useMediaSourceSession;

package/dist/debug-ui/media-source.js

@@ -1,4 +1,4 @@
-import { M as a, d, s as i, a as o, u as r, b as u } from "../session-DLFN_VII.js";
+import { M as a, d, s as i, a as o, u as r, b as u } from "../session-DgA_z6O1.js";
 export {
   a as MediaSourceSwitcher,
   d as defaultMediaSources,

package/dist/debug-ui/object-inspector-panel/index.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
-export type ObjectInspectorPanelProps = {
+import { DebugWindowPlacementProps } from '../shared/debugWindow';
+export type ObjectInspectorPanelProps = DebugWindowPlacementProps & {
     children: ReactNode;
     copyConfig: unknown;
     initialPosition?: {
@@ -22,4 +23,4 @@ export type ObjectInspectorPanelProps = {
     visible: boolean;
     onVisibleChange: (visible: boolean) => void;
 };
-export declare const ObjectInspectorPanel: ({ children, copyConfig, initialPosition, layer, objectId, objectName, onObjectNameChange, onPositionChange, onVisibleChange, position: controlledPosition, title, visible, }: ObjectInspectorPanelProps) => import('react').ReactPortal | null;
+export declare const ObjectInspectorPanel: ({ children, copyConfig, docked, initialPosition, layer, objectId, objectName, onObjectNameChange, onPositionChange, onVisibleChange, position: controlledPosition, title, visible, }: ObjectInspectorPanelProps) => ReactNode;

package/dist/debug-ui/product-hotspots/index.d.ts

@@ -0,0 +1,25 @@
+import { UseProductHotspotsResult } from '../../product/useProductDetails';
+import { DebugWindowPlacementProps } from '../shared/debugWindow';
+export type ProductHotspotPanelProps = DebugWindowPlacementProps & {
+    title?: string;
+    hotspots: UseProductHotspotsResult;
+    /** Called when placement mode toggles; the page forwards pointer clicks on the viewer to `placeFromPointer` while on. */
+    placing: boolean;
+    onPlacingChange: (placing: boolean) => void;
+    /** Variants from `useProductVariants`, optional. */
+    variants?: {
+        variants: string[];
+        variant: string | null;
+        setVariant: (name: string | null) => void;
+    };
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+};
+/**
+ * Authoring panel for product hotspots (and variants): toggle click-to-place,
+ * edit labels, remove, copy the JSON. Debug UI only; the data it produces is
+ * what the app ships as `initial` to `useProductHotspots`.
+ */
+export declare const ProductHotspotPanel: ({ title, hotspots, placing, onPlacingChange, variants, initialPosition, docked, }: ProductHotspotPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/scene-editor/hierarchy-panel.d.ts

@@ -5,5 +5,7 @@ export type SceneHierarchyPanelProps = {
         y: number;
     };
     rootOnly?: boolean;
+    /** Render in place inside its host instead of floating (see `DebugWindowPlacementProps`). */
+    docked?: boolean;
 };
-export declare const SceneHierarchyPanel: ({ initialPosition, rootOnly, title, }: SceneHierarchyPanelProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SceneHierarchyPanel: ({ initialPosition, rootOnly, title, docked, }: SceneHierarchyPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/scene-editor/inspector-panel.d.ts

@@ -3,5 +3,7 @@ export type SceneInspectorPanelProps = {
         x: number;
         y: number;
     };
+    /** Render in place inside its host instead of floating (see `DebugWindowPlacementProps`). */
+    docked?: boolean;
 };
-export declare const SceneInspectorPanel: ({ initialPosition }: SceneInspectorPanelProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const SceneInspectorPanel: ({ initialPosition, docked }: SceneInspectorPanelProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/debug-ui/screen-image-settings/index.d.ts

@@ -5,5 +5,7 @@ export type ScreenImageSettingsPanelProps = {
     onChange: (next: ScreenImageSceneSettings) => void;
     copyLabel?: string;
     inspector?: Omit<ObjectInspectorPanelProps, "children">;
+    /** Render in place inside its host instead of floating (see `DebugWindowPlacementProps`). */
+    docked?: boolean;
 };
-export declare const ScreenImageSettingsPanel: ({ value, onChange, copyLabel, inspector, }: ScreenImageSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ScreenImageSettingsPanel: ({ value, onChange, copyLabel, inspector, docked, }: ScreenImageSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/screen-text-settings/ScreenTextSettingsPanel.d.ts

@@ -1,3 +1,3 @@
 import { ScreenTextSettingsPanelProps } from './types';
 export type * from './types';
-export declare const ScreenTextSettingsPanel: ({ value, onChange, copyLabel, inspector, }: ScreenTextSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ScreenTextSettingsPanel: ({ value, onChange, copyLabel, inspector, docked, }: ScreenTextSettingsPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/screen-text-settings/types.d.ts

@@ -6,4 +6,6 @@ export type ScreenTextSettingsPanelProps = {
     onChange: (next: ScreenTextSceneSettings) => void;
     copyLabel?: string;
     inspector?: Omit<ObjectInspectorPanelProps, "children">;
+    /** Render in place inside its host instead of floating (see `DebugWindowPlacementProps`). */
+    docked?: boolean;
 };

package/dist/debug-ui/segmentation-overlay-settings/index.d.ts

@@ -0,0 +1,12 @@
+import { SegmentationOverlaySettings } from '../../components/SegmentationOverlay';
+export type SegmentationOverlaySettingsPanelProps = {
+    title?: string;
+    value: Partial<SegmentationOverlaySettings>;
+    onChange: (next: SegmentationOverlaySettings) => void;
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+};
+/** Live controls for `SegmentationOverlay`; spread the emitted settings onto the component. */
+export declare const SegmentationOverlaySettingsPanel: ({ title, value, onChange, initialPosition, }: SegmentationOverlaySettingsPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/debug-ui/settings-panel/index.d.ts

@@ -1,4 +1,9 @@
-export type SettingsPanelValue = string | number | boolean;
+/**
+ * A field value. A list is one select option (a set of regions, say): panels
+ * match options by `String(value)`, so give a list in the order the settings
+ * resolve it to.
+ */
+export type SettingsPanelValue = string | number | boolean | readonly string[];
 export type SettingsPanelOption = {
     label: string;
     value: SettingsPanelValue;