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

package/dist/{FaceMeshRenderer-DSCd1H55.js → FaceMeshRenderer-wjAHrJzP.js}

@@ -1,11 +1,11 @@
-import { jsx as g, jsxs as we, Fragment as Ye } from "react/jsx-runtime";
+import { jsx as g, jsxs as Fe, Fragment as Ye } from "react/jsx-runtime";
 import { useLoader as de, useThree as Bt, useFrame as Vt } from "@react-three/fiber";
 import { useMemo as Z, useRef as l, useState as $e, useCallback as He, useEffect as Ce } from "react";
 import * as m from "three";
 import { MathUtils as Ke, Color as Wt, Vector2 as Be } from "three";
-import { l as re, f as Xt, X as jt } from "./index-I4eF5TKT.js";
-import { c as Yt, u as $t } from "./selectors-ByKNTXeA.js";
-import { t as Kt, p as Qt, b as qt } from "./index-B-s4YbWu.js";
+import { l as re, f as Xt, X as jt } from "./index-9dlAQAhy.js";
+import { c as Yt, u as $t } from "./selectors-B8H97CKA.js";
+import { t as Kt, p as Qt, b as qt } from "./index-ByoNj0QP.js";
 import { TransformControls as Zt } from "@react-three/drei";
 const _e = 8, K = {
   type: "linear",
@@ -98,7 +98,7 @@ const _e = 8, K = {
       toneMapped: !1
     }
   );
-}, on = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO2YpZcAAAAASUVORK5CYII=", jn = {
+}, on = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO2YpZcAAAAASUVORK5CYII=", Yn = {
   source: "solid",
   color: "#ffffff",
   opacity: 1,
@@ -180,13 +180,13 @@ const _e = 8, K = {
   rotation: { x: 0, y: 0, z: 0 },
   scale: { x: 1, y: 1, z: 1 },
   visible: !0
-}, Yn = ({ children: e, objectRef: n, onChange: t, value: r }) => {
+}, $n = ({ children: e, objectRef: n, onChange: t, value: r }) => {
   const a = l(null), o = l(n);
   o.current = n;
-  const [i, s] = $e(null), u = He((c) => {
+  const [i, s] = $e(null), f = He((c) => {
     var v;
     a.current = c, s(c), (v = o.current) == null || v.call(o, c);
-  }, []), f = He(() => {
+  }, []), u = He(() => {
     const c = a.current;
     !c || !t || t({
       ...r,
@@ -207,11 +207,11 @@ const _e = 8, K = {
       }
     });
   }, [t, r]);
-  return r.enabled ? /* @__PURE__ */ we(Ye, { children: [
+  return r.enabled ? /* @__PURE__ */ Fe(Ye, { children: [
     /* @__PURE__ */ g(
       "group",
       {
-        ref: u,
+        ref: f,
         position: [r.position.x, r.position.y, r.position.z],
         rotation: [
           r.rotation.x * Me,
@@ -230,8 +230,8 @@ const _e = 8, K = {
         mode: r.transformControlMode,
         space: r.transformControlSpace,
         size: 0.85,
-        onMouseUp: f,
-        onObjectChange: f
+        onMouseUp: u,
+        onObjectChange: u
       }
     )
   ] }) : null;
@@ -248,21 +248,21 @@ const _e = 8, K = {
   };
 }, dn = (e) => e != null && e.enabled ? (e.strength ?? 1) !== 0 && Object.entries(e).some(
   ([n, t]) => n !== "enabled" && n !== "strength" && typeof t == "number" && t !== 0
-) : !1, un = (e, n, t, r) => {
+) : !1, fn = (e, n, t, r) => {
   const a = t.enabled ? t.strength ?? 1 : 0;
   if (a === 0)
     return r.x = e.x, r.y = e.y, r.z = e.z, r;
-  const o = (e.x - n.centerX) / n.width, i = (e.y - n.centerY) / n.height, s = Math.abs(o), u = te((-i + 0.42) / 0.55), f = L(i, -0.02, 0.34), c = L(i, -0.24, 0.16) * te((s - 0.05) / 0.28), v = L(i, 0.02, 0.26) * L(s, 0, 0.18), R = L(i, 0.29, 0.18) * L(s, 0, 0.36), D = te((i - 0.16) / 0.36), _ = f * L(s, 0.34, 0.22), w = u * L(s, 0, 0.48), S = L(i, -0.19, 0.1) * te((s - 0.05) / 0.3), Y = L(i, 0.48, 0.2) * L(s, 0, 0.26);
+  const o = (e.x - n.centerX) / n.width, i = (e.y - n.centerY) / n.height, s = Math.abs(o), f = te((-i + 0.42) / 0.55), u = L(i, -0.02, 0.34), c = L(i, -0.24, 0.16) * te((s - 0.05) / 0.28), v = L(i, 0.02, 0.26) * L(s, 0, 0.18), R = L(i, 0.29, 0.18) * L(s, 0, 0.36), D = te((i - 0.16) / 0.36), _ = u * L(s, 0.34, 0.22), F = f * L(s, 0, 0.48), S = L(i, -0.19, 0.1) * te((s - 0.05) / 0.3), Y = L(i, 0.48, 0.2) * L(s, 0, 0.26);
   let M = e.x, p = e.y, U = e.z;
   const y = (T, h = 1) => {
     M += o * n.width * T * a * h;
   }, d = (T, h = 1) => {
     p += i * n.height * T * a * h;
   };
-  y(t.faceWidth ?? 0), d(t.faceHeight ?? 0), y(t.faceRoundness ?? 0, f * (1 - s)), p -= n.height * (t.midfaceHeight ?? 0) * a * f * 0.25, d(-(t.foreheadHeight ?? 0), w), y(t.foreheadWidth ?? 0, w), y(
+  y(t.faceWidth ?? 0), d(t.faceHeight ?? 0), y(t.faceRoundness ?? 0, u * (1 - s)), p -= n.height * (t.midfaceHeight ?? 0) * a * u * 0.25, d(-(t.foreheadHeight ?? 0), F), y(t.foreheadWidth ?? 0, F), y(
     t.cheekboneWidth ?? 0,
     L(i, -0.06, 0.16) * L(s, 0.34, 0.2)
-  ), y(t.cheekWidth ?? 0, _), y(t.jawWidth ?? 0, D), d(t.chinHeight ?? 0, Y), p -= n.height * (t.scalpHeight ?? 0) * a * u * 0.3, U -= (t.midfaceDepth ?? 0) * a * f * 0.08, U += (t.cheekHollowness ?? 0) * a * _ * 0.06, U -= (t.browDepth ?? 0) * a * S * 0.05, p -= n.height * (t.browHeight ?? 0) * a * S * 0.2, M += Math.sign(o || 1) * n.width * (t.browDistance ?? 0) * a * S * 0.16;
+  ), y(t.cheekWidth ?? 0, _), y(t.jawWidth ?? 0, D), d(t.chinHeight ?? 0, Y), p -= n.height * (t.scalpHeight ?? 0) * a * f * 0.3, U -= (t.midfaceDepth ?? 0) * a * u * 0.08, U += (t.cheekHollowness ?? 0) * a * _ * 0.06, U -= (t.browDepth ?? 0) * a * S * 0.05, p -= n.height * (t.browHeight ?? 0) * a * S * 0.2, M += Math.sign(o || 1) * n.width * (t.browDistance ?? 0) * a * S * 0.16;
   const k = (t.headCurve ?? 0) * a * (i + 0.1);
   U -= k * k * 0.04 * Math.sign(t.headCurve ?? 0), M += n.width * (t.faceTwist ?? 0) * a * i * 0.18;
   const N = (t.faceSwirl ?? 0) * a * 0.22;
@@ -358,42 +358,42 @@ const _e = 8, K = {
   385,
   384,
   398
-]), fn = /* @__PURE__ */ new Set([814, 815, 816, 817, 818, 819, 830, 831, 832, 833]), hn = (e, n, t) => {
+]), un = /* @__PURE__ */ new Set([814, 815, 816, 817, 818, 819, 830, 831, 832, 833]), hn = (e, n, t) => {
   const r = Ae.has(e) && Ae.has(n) && Ae.has(t), a = ve.has(e) && ve.has(n) && ve.has(t), o = Ee.has(e) && Ee.has(n) && Ee.has(t);
   return r ? "mouth" : a ? "leftEye" : o ? "rightEye" : "base";
 }, mn = (e) => {
   const n = /* @__PURE__ */ new Map();
   for (let s = 0; s < e.length; s += 3) {
-    const u = [e[s], e[s + 1], e[s + 2]];
-    for (let f = 0; f < 3; f += 1) {
-      const c = u[f], v = u[(f + 1) % 3], R = c < v ? `${c}:${v}` : `${v}:${c}`, D = n.get(R);
+    const f = [e[s], e[s + 1], e[s + 2]];
+    for (let u = 0; u < 3; u += 1) {
+      const c = f[u], v = f[(u + 1) % 3], R = c < v ? `${c}:${v}` : `${v}:${c}`, D = n.get(R);
       D ? D.count += 1 : n.set(R, { a: c, b: v, count: 1 });
     }
   }
   const t = /* @__PURE__ */ new Map();
-  n.forEach(({ a: s, b: u, count: f }) => {
-    f === 1 && (t.set(s, [...t.get(s) ?? [], u]), t.set(u, [...t.get(u) ?? [], s]));
+  n.forEach(({ a: s, b: f, count: u }) => {
+    u === 1 && (t.set(s, [...t.get(s) ?? [], f]), t.set(f, [...t.get(f) ?? [], s]));
   });
-  const r = [...t.keys()].sort((s, u) => s - u)[0];
+  const r = [...t.keys()].sort((s, f) => s - f)[0];
   if (r === void 0) return [];
   const a = [r];
   let o = -1, i = r;
   for (; a.length <= t.size + 1; ) {
-    const s = (t.get(i) ?? []).find((u) => u !== o);
+    const s = (t.get(i) ?? []).find((f) => f !== o);
     if (s === void 0 || s === r) break;
     a.push(s), o = i, i = s;
   }
   return a;
 }, pn = (e) => {
-  const n = [], t = [], r = [], a = [], o = [], i = [], s = [], u = [];
-  let f = 0, c = 0;
+  const n = [], t = [], r = [], a = [], o = [], i = [], s = [], f = [];
+  let u = 0, c = 0;
   e.split(`
 `).forEach((y) => {
     const d = y.trim();
     if (!d) return;
     if (d.startsWith("v ")) {
       const [, x, E, T] = d.split(/\s+/);
-      s.push([Number(x), Number(E), Number(T)]), f += 1;
+      s.push([Number(x), Number(E), Number(T)]), u += 1;
       return;
     }
     if (d.startsWith("vt ")) {
@@ -406,28 +406,28 @@ const _e = 8, K = {
     c += 1;
     const [, ...N] = d.split(/\s+/), I = N.map((x) => {
       const [E, T] = x.split("/"), h = Number(E) - 1, z = Number(T) - 1;
-      return z >= 0 && i[z] && !u[h] && (u[h] = i[z]), h;
+      return z >= 0 && i[z] && !f[h] && (f[h] = i[z]), h;
     });
     if (!(I.length < 3))
       for (let x = 1; x < I.length - 1; x += 1) {
         const E = I[0], T = I[x], h = I[x + 1], z = hn(E, T, h);
-        fn.has(k) ? o.push(E, T, h) : z === "mouth" ? t.push(E, T, h) : z === "leftEye" ? r.push(E, T, h) : z === "rightEye" ? a.push(E, T, h) : n.push(E, T, h);
+        un.has(k) ? o.push(E, T, h) : z === "mouth" ? t.push(E, T, h) : z === "leftEye" ? r.push(E, T, h) : z === "rightEye" ? a.push(E, T, h) : n.push(E, T, h);
       }
   });
   const v = [];
-  for (let y = 0; y < f; y += 1) {
-    const [d, k] = u[y] ?? [0, 0];
+  for (let y = 0; y < u; y += 1) {
+    const [d, k] = f[y] ?? [0, 0];
     v.push(d, k);
   }
   const R = new Uint16Array(r), D = new Uint16Array(a), _ = new Uint16Array(r.length + a.length);
   _.set(R), _.set(D, R.length);
-  const w = We.map((y) => {
+  const F = We.map((y) => {
     const [d, k] = s[y] ?? [0, 0];
     return new m.Vector2(d, k);
   }), S = mn(t), Y = S.map((y) => {
     const [d, k] = s[y] ?? [0, 0];
     return new m.Vector2(d, k);
-  }), M = m.ShapeUtils.triangulateShape(w, [Y]), p = [...We, ...S], U = new Uint16Array(
+  }), M = m.ShapeUtils.triangulateShape(F, [Y]), p = [...We, ...S], U = new Uint16Array(
     S.length > 2 ? M.flatMap((y) => y.map((d) => p[d])) : []
   );
   return {
@@ -439,7 +439,7 @@ const _e = 8, K = {
     eyeIndices: _,
     noseIndices: new Uint16Array(o),
     uvs: new Float32Array(v),
-    vertexCount: f
+    vertexCount: u
   };
 }, yn = "canonical_face_model.obj", bn = new TextDecoder("utf-8"), Se = /* @__PURE__ */ new Map(), gn = (e) => {
   const n = Se.get(e);
@@ -538,7 +538,7 @@ const Te = {
   textureSource: ae.solid,
   color: "#111111",
   opacity: 0.5
-}, An = 24, Ze = 10, Fe = (e, n, t) => e !== C.shader ? "none" : n === X.originalFace ? "originalFace" : n === X.composite ? t === j.none ? "originalFace" : "composite" : "none", $n = (e, n) => e === C.basic || e === C.standard || e === C.physical || e === C.toon || e === C.shader && n === X.composite, Kn = (e, n, t = j.canonical) => Fe(e, n, t) === "composite", vn = (e, n, t) => Fe(e, n, t) === "originalFace", ke = (e) => e === ae.imageUrl || e === ae.mediaUrl, En = (e) => e === ae.solid || e === ae.gradient, je = {
+}, An = 24, Ze = 10, we = (e, n, t) => e !== C.shader ? "none" : n === X.originalFace ? "originalFace" : n === X.composite ? t === j.none ? "originalFace" : "composite" : "none", Kn = (e, n) => e === C.basic || e === C.standard || e === C.physical || e === C.toon || e === C.shader && n === X.composite, Qn = (e, n, t = j.canonical) => we(e, n, t) === "composite", vn = (e, n, t) => we(e, n, t) === "originalFace", ke = (e) => e === ae.imageUrl || e === ae.mediaUrl, En = (e) => e === ae.solid || e === ae.gradient, je = {
   normal: 0,
   add: 1,
   subtract: 2,
@@ -699,14 +699,14 @@ const Te = {
   color: o,
   compositeShading: i,
   faceAlphaMaskUrl: s,
-  faceTextureStyle2Url: u,
-  faceTextureUrl: f,
+  faceTextureStyle2Url: f,
+  faceTextureUrl: u,
   masked: c = !1,
   maskColor: v,
   maskOpacity: R,
   maskSourceUrl: D,
   maskTextureSource: _,
-  materialType: w,
+  materialType: F,
   opacity: S,
   shaderPreset: Y,
   side: M,
@@ -714,10 +714,10 @@ const Te = {
 }) => {
   const U = de(
     m.TextureLoader,
-    f || Re
+    u || Re
   ), y = de(
     m.TextureLoader,
-    u || f || Re
+    f || u || Re
   ), d = de(
     m.TextureLoader,
     s || Re
@@ -728,7 +728,7 @@ const Te = {
     },
     [N, k]
   );
-  const I = p === j.style2 ? y : U, x = p !== j.none, E = Fe(w, Y, p), T = [
+  const I = p === j.style2 ? y : U, x = p !== j.none, E = we(F, Y, p), T = [
     "composite-material",
     p,
     e,
@@ -738,8 +738,8 @@ const Te = {
     i ? "lit" : "flat",
     o,
     S,
-    f,
     u,
+    f,
     s
   ].join("|"), h = {
     side: M,
@@ -755,7 +755,7 @@ const Te = {
       gradient: Qe(v)
     }),
     [v, R, D, _]
-  ), F = Z(
+  ), w = Z(
     () => ({
       cameraTexture: { value: null },
       canonicalTexture: { value: null },
@@ -784,7 +784,7 @@ const Te = {
     ]
   );
   if (Ce(() => {
-    F.cameraTexture.value = a ?? U, F.canonicalTexture.value = I, F.alphaMask.value = d, F.textureTint.value.set(o), F.opacity.value = S, F.blendMode.value = je[t], F.blendOpacity.value = r, F.useCanonicalTexture.value = x ? 1 : 0, F.useAlphaMask.value = e === J.canonical ? 1 : 0, F.alphaOpacity.value = n, F.compositeShading.value = i ? 1 : 0;
+    w.cameraTexture.value = a ?? U, w.canonicalTexture.value = I, w.alphaMask.value = d, w.textureTint.value.set(o), w.opacity.value = S, w.blendMode.value = je[t], w.blendOpacity.value = r, w.useCanonicalTexture.value = x ? 1 : 0, w.useAlphaMask.value = e === J.canonical ? 1 : 0, w.alphaOpacity.value = n, w.compositeShading.value = i ? 1 : 0;
   }, [
     e,
     d,
@@ -794,7 +794,7 @@ const Te = {
     a,
     o,
     i,
-    F,
+    w,
     U,
     x,
     S,
@@ -808,7 +808,7 @@ const Te = {
       },
       `masked-${_}-material`
     );
-  if (w === C.wireframe)
+  if (F === C.wireframe)
     return /* @__PURE__ */ g(
       "meshBasicMaterial",
       {
@@ -842,7 +842,7 @@ const Te = {
     return /* @__PURE__ */ g(
       "shaderMaterial",
       {
-        uniforms: F,
+        uniforms: w,
         vertexShader: Rn,
         fragmentShader: Cn,
         transparent: !0,
@@ -853,8 +853,8 @@ const Te = {
       },
       T
     );
-  const Q = x ? I : null, $ = e === J.canonical && n > 0 ? d : null, W = `${w}-${p}-${e}-${n > 0 ? "alpha-on" : "alpha-off"}`;
-  return w === C.standard ? /* @__PURE__ */ g(
+  const Q = x ? I : null, $ = e === J.canonical && n > 0 ? d : null, W = `${F}-${p}-${e}-${n > 0 ? "alpha-on" : "alpha-off"}`;
+  return F === C.standard ? /* @__PURE__ */ g(
     "meshStandardMaterial",
     {
       ...h,
@@ -867,7 +867,7 @@ const Te = {
       roughness: 0.72
     },
     W
-  ) : w === C.physical ? /* @__PURE__ */ g(
+  ) : F === C.physical ? /* @__PURE__ */ g(
     "meshPhysicalMaterial",
     {
       ...h,
@@ -882,7 +882,7 @@ const Te = {
       clearcoatRoughness: 0.4
     },
     W
-  ) : w === C.toon ? /* @__PURE__ */ g(
+  ) : F === C.toon ? /* @__PURE__ */ g(
     "meshToonMaterial",
     {
       ...h,
@@ -894,7 +894,7 @@ const Te = {
       depthTest: !0
     },
     W
-  ) : w === C.normal ? /* @__PURE__ */ g(
+  ) : F === C.normal ? /* @__PURE__ */ g(
     "meshNormalMaterial",
     {
       ...h,
@@ -903,7 +903,7 @@ const Te = {
       flatShading: !1
     },
     "normal-material"
-  ) : w === C.matcap ? /* @__PURE__ */ g(
+  ) : F === C.matcap ? /* @__PURE__ */ g(
     "meshMatcapMaterial",
     {
       ...h,
@@ -987,11 +987,11 @@ const Te = {
     masked: !0,
     renderOrderOffset: 3
   }
-], wn = {
+], Fn = {
   [ne.front]: m.FrontSide,
   [ne.back]: m.BackSide,
   [ne.double]: m.DoubleSide
-}, Fn = (e, n, t) => {
+}, wn = (e, n, t) => {
   e.setAttribute("position", n.position), e.setAttribute("uv", n.uv), e.setAttribute("faceUv", n.faceUv), e.setIndex(new m.BufferAttribute(t, 1));
 }, Un = ({
   faceIndex: e = 0,
@@ -1002,21 +1002,23 @@ const Te = {
   shaderPreset: o = G.shaderPreset,
   textureMap: i = G.textureMap,
   alphaMap: s = G.alphaMap,
-  alphaOpacity: u = G.alphaOpacity,
-  side: f = G.side,
+  alphaOpacity: f = G.alphaOpacity,
+  side: u = G.side,
   blendMode: c = G.blendMode,
   blendOpacity: v = G.blendOpacity,
   showOverlayMask: R = !1,
   showMouthMask: D = Te.mouth,
   showEyeMask: _ = Te.eyes,
-  showLeftEyeMask: w,
+  showLeftEyeMask: F,
   showRightEyeMask: S,
   showNoseMask: Y = Te.nose,
   showEyeGeometry: M = !0,
   showLeftEyeGeometry: p,
   showRightEyeGeometry: U,
   showMouthGeometry: y = !0,
-  showLipsGeometry: d = !0,
+  // The lips mesh is an effect-only overlay. Rendering it with the base face
+  // mesh duplicates an incomplete triangulation over the mouth.
+  showLipsGeometry: d = !1,
   showBaseGeometry: k = !0,
   showNoseGeometry: N = !0,
   maskTextureSource: I = ee.textureSource,
@@ -1025,17 +1027,17 @@ const Te = {
   maskOpacity: T = ee.opacity,
   faceTextureUrl: h = "",
   faceTextureStyle2Url: z = "",
-  faceAlphaMaskUrl: F = "",
+  faceAlphaMaskUrl: w = "",
   compositeShading: Q = !1,
   faceWarp3D: $,
   transform: W,
   renderOrder: Je = Ze,
-  externalScale: ue = 1,
+  externalScale: fe = 1,
   mesh: et,
   meshUrl: tt,
   materialOverride: oe
 }) => {
-  const fe = Yt(jt.FACE_TRACKER), Ue = $t(), { camera: nt } = Bt(), H = Mn({ mesh: et, url: tt }), Ie = l(null), rt = l(null), at = l(null), ot = l(null), st = l(null), it = l(null), ct = l(null), lt = l(null), dt = l(null), ut = l(null), ft = l(null), ht = l(null), mt = l(null), pt = l(null), yt = l(null), bt = l(null), gt = l(null), Mt = l(null), xt = l(null), At = l(null), he = l(null), me = l(null), pe = l(null), Oe = l(null), vt = l(new m.Vector3()), Et = l({ x: 0, y: 0, z: 0 }), St = l({ x: 0, y: 0, z: 0 }), Tt = l({ x: 0, y: 0, z: 0 }), se = l(!1), Rt = wn[f], Ct = n ?? t, _t = p ?? M, kt = U ?? M, wt = R || (w ?? _), Ft = R || (S ?? _), Ut = R || D, It = R || Y, Ot = {
+  const ue = Yt(jt.FACE_TRACKER), Ue = $t(), { camera: nt } = Bt(), H = Mn({ mesh: et, url: tt }), Ie = l(null), rt = l(null), at = l(null), ot = l(null), st = l(null), it = l(null), ct = l(null), lt = l(null), dt = l(null), ft = l(null), ut = l(null), ht = l(null), mt = l(null), pt = l(null), yt = l(null), bt = l(null), gt = l(null), Mt = l(null), xt = l(null), At = l(null), he = l(null), me = l(null), pe = l(null), Oe = l(null), vt = l(new m.Vector3()), Et = l({ x: 0, y: 0, z: 0 }), St = l({ x: 0, y: 0, z: 0 }), Tt = l({ x: 0, y: 0, z: 0 }), se = l(!1), Rt = Fn[u], Ct = n ?? t, _t = p ?? M, kt = U ?? M, Ft = R || (F ?? _), wt = R || (S ?? _), Ut = R || D, It = R || Y, Ot = {
     base: Ie,
     mouth: rt,
     lips: at,
@@ -1045,9 +1047,9 @@ const Te = {
     "mouth-mask": ct,
     "left-eye-mask": lt,
     "right-eye-mask": dt,
-    "nose-mask": ut
+    "nose-mask": ft
   }, Lt = {
-    base: ft,
+    base: ut,
     mouth: ht,
     lips: mt,
     "left-eye": pt,
@@ -1065,20 +1067,20 @@ const Te = {
     "right-eye": kt,
     nose: N,
     "mouth-mask": Ut,
-    "left-eye-mask": wt,
-    "right-eye-mask": Ft,
+    "left-eye-mask": Ft,
+    "right-eye-mask": wt,
     "nose-mask": It
   }, Pt = (A) => /* @__PURE__ */ g(
     _n,
     {
       alphaMap: s,
-      alphaOpacity: u,
+      alphaOpacity: f,
       blendMode: c,
       blendOpacity: v,
       cameraTexture: Ue,
       color: Ct,
       compositeShading: Q,
-      faceAlphaMaskUrl: F,
+      faceAlphaMaskUrl: w,
       faceTextureStyle2Url: z,
       faceTextureUrl: h,
       masked: A,
@@ -1102,7 +1104,7 @@ const Te = {
   ), zt = (A) => Qt(A, nt, vt.current);
   return Vt(() => {
     var ze, Ge;
-    const A = Ie.current, B = (Ge = (ze = fe == null ? void 0 : fe.detectionResults) == null ? void 0 : ze.faceLandmarks) == null ? void 0 : Ge[e], Gt = q.every(
+    const A = Ie.current, B = (Ge = (ze = ue == null ? void 0 : ue.detectionResults) == null ? void 0 : ze.faceLandmarks) == null ? void 0 : Ge[e], Gt = q.every(
       (b) => b.geometryRef.current && b.meshRef.current
     );
     if (!H || !A || !Gt) return;
@@ -1120,7 +1122,7 @@ const Te = {
         faceUv: new m.BufferAttribute(pe.current, 2)
       };
       q.forEach((O) => {
-        Fn(O.geometryRef.current, b, O.getIndices(H));
+        wn(O.geometryRef.current, b, O.getIndices(H));
       }), b.uv.needsUpdate = !0, Oe.current = H, se.current = !1;
     }
     const ie = he.current, ye = pe.current, ce = me.current;
@@ -1136,7 +1138,7 @@ const Te = {
     }
     const Nt = Math.min(B.length, H.vertexCount);
     for (let b = 0; b < Nt; b++) {
-      const O = B[b], Ne = De && Pe ? un(O, Pe, $, Et.current) : O, Ht = W && P ? Kt(
+      const O = B[b], Ne = De && Pe ? fn(O, Pe, $, Et.current) : O, Ht = W && P ? Kt(
         Ne,
         P,
         W,
@@ -1149,7 +1151,7 @@ const Te = {
     }), A.attributes.position.needsUpdate = !0, A.attributes.faceUv.needsUpdate = !0, q.forEach((b) => {
       b.geometryRef.current.computeVertexNormals();
     });
-  }), /* @__PURE__ */ g("group", { scale: [ue, ue, ue], children: q.map((A) => /* @__PURE__ */ we(
+  }), /* @__PURE__ */ g("group", { scale: [fe, fe, fe], children: q.map((A) => /* @__PURE__ */ Fe(
     "mesh",
     {
       ref: A.meshRef,
@@ -1165,7 +1167,7 @@ const Te = {
 }, In = `${re.sdkAssetsBaseUrl}/Canonical_Face_Color.png`, On = `${re.sdkAssetsBaseUrl}/Canonical_Face_Color_style_2.png`, Ln = `${re.sdkAssetsBaseUrl}/Canonical_Face_Color_Mask.png`, Dn = {
   ...Ve,
   position: { ...Ve.position, y: 1e-3 }
-}, Qn = {
+}, qn = {
   enabled: !0,
   faceIndex: 0,
   targetFps: An,
@@ -1191,7 +1193,13 @@ const Te = {
 }, Pn = (e) => {
   const { externalMeshUrl: n, ...t } = e;
   return { ...t, color: t.baseColor, meshUrl: n };
-}, qn = (e, n) => {
+}, zn = ({
+  materialOverride: e,
+  value: n
+}) => ({
+  ...Pn(n),
+  materialOverride: e
+}), Zn = (e, n) => {
   const t = { ...e, ...n };
   return n.maskTextureSource && !ke(n.maskTextureSource) && (t.maskSourceUrl = ""), t.materialType === C.shader && n.shaderPreset === X.composite ? {
     ...t,
@@ -1202,10 +1210,7 @@ const Te = {
     ...t,
     textureMap: Xe.textureMap
   } : t;
-}, Zn = ({
-  transform: e,
-  value: n
-}) => n.enabled ? /* @__PURE__ */ we(Ye, { children: [
+}, Jn = ({ transform: e, value: n, materialOverride: t }) => n.enabled ? /* @__PURE__ */ Fe(Ye, { children: [
   /* @__PURE__ */ g(
     qt,
     {
@@ -1218,20 +1223,21 @@ const Te = {
   /* @__PURE__ */ g(
     Un,
     {
-      ...Pn(n),
+      ...zn({ value: n, materialOverride: t }),
       transform: e ?? Dn
     }
   )
 ] }) : null;
 export {
-  Qe as A,
-  Ve as B,
+  Yn as A,
+  Qe as B,
   Un as C,
   G as D,
-  _e as E,
+  Ve as E,
   C as F,
-  En as G,
-  ke as H,
+  _e as G,
+  En as H,
+  ke as I,
   cn as M,
   an as S,
   Re as T,
@@ -1242,23 +1248,23 @@ export {
   qe as e,
   ae as f,
   je as g,
-  Qn as h,
+  qn as h,
   Dn as i,
   Te as j,
-  Kn as k,
+  Qn as k,
   _n as l,
-  Zn as m,
+  Jn as m,
   Ln as n,
   On as o,
   In as p,
   kn as q,
-  Pn as r,
-  $n as s,
-  qn as t,
-  Mn as u,
-  pn as v,
-  K as w,
-  en as x,
-  Yn as y,
-  jn as z
+  zn as r,
+  Kn as s,
+  Pn as t,
+  Zn as u,
+  Mn as v,
+  pn as w,
+  K as x,
+  en as y,
+  $n as z
 };

package/dist/{FaceRetouch-DsE0Dbw-.cjs → FaceRetouch-BkJzoA79.cjs}

@@ -1,4 +1,4 @@
-"use strict";const o=require("./FaceMeshRenderer-D1WsrTLA.cjs"),M=require("react/jsx-runtime"),S=require("react"),D=require("./index-C0-fg1Hk.cjs"),y=require("./index-CxMEeCRP.cjs"),T=require("@react-three/fiber"),U=require("three"),B=require("./selectors-CAwmL9VW.cjs");function N(e){const a=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const t in e)if(t!=="default"){const r=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(a,t,r.get?r:{enumerable:!0,get:()=>e[t]})}}return a.default=e,Object.freeze(a)}const p=N(U),w={enabled:!1,strength:1,faceWidth:0,faceHeight:0,faceRoundness:0,midfaceHeight:0,foreheadHeight:0,foreheadWidth:0,cheekboneWidth:0,cheekWidth:0,cheekHollowness:0,midfaceDepth:0,scalpHeight:0,headCurve:0,faceTwist:0,faceSwirl:0,browDistance:0,browHeight:0,browDepth:0,eyeSize:0,leftEyeSize:0,rightEyeSize:0,eyeDistance:0,leftEyeX:0,rightEyeX:0,leftEyeY:0,rightEyeY:0,noseSize:0,noseLength:0,mouthWidth:0,mouthHeight:0,jawWidth:0,chinHeight:0},I={...w,enabled:!0,strength:1,faceWidth:-.08,faceHeight:.04,foreheadHeight:.04,cheekWidth:-.04,eyeSize:.08,eyeDistance:.03,noseSize:-.05,noseLength:.03,mouthWidth:.06,mouthHeight:.02,jawWidth:-.05,chinHeight:.03},X=[{label:"Wireframe",value:o.FACE_MESH_MATERIAL_TYPES.wireframe},{label:"Basic",value:o.FACE_MESH_MATERIAL_TYPES.basic},{label:"Standard",value:o.FACE_MESH_MATERIAL_TYPES.standard},{label:"Physical",value:o.FACE_MESH_MATERIAL_TYPES.physical},{label:"Toon",value:o.FACE_MESH_MATERIAL_TYPES.toon},{label:"Normal",value:o.FACE_MESH_MATERIAL_TYPES.normal},{label:"Matcap",value:o.FACE_MESH_MATERIAL_TYPES.matcap},{label:"Shader",value:o.FACE_MESH_MATERIAL_TYPES.shader}],W=[{label:"Original Face",value:o.FACE_MESH_SHADER_PRESETS.originalFace},{label:"Composite",value:o.FACE_MESH_SHADER_PRESETS.composite}],Y=[{label:"Front",value:o.FACE_MESH_SIDES.front},{label:"Back",value:o.FACE_MESH_SIDES.back},{label:"Double",value:o.FACE_MESH_SIDES.double}],j=[{label:"None",value:o.FACE_MESH_TEXTURE_MAPS.none},{label:"UV Map 1",value:o.FACE_MESH_TEXTURE_MAPS.canonical},{label:"UV Map 2",value:o.FACE_MESH_TEXTURE_MAPS.style2}],q=[{label:"None",value:o.FACE_MESH_ALPHA_MAPS.none},{label:"Default Mask",value:o.FACE_MESH_ALPHA_MAPS.canonical}],G=[{label:"Solid",value:o.FACE_MESH_MASK_TEXTURE_SOURCES.solid},{label:"Gradient",value:o.FACE_MESH_MASK_TEXTURE_SOURCES.gradient},{label:"Image URL",value:o.FACE_MESH_MASK_TEXTURE_SOURCES.imageUrl},{label:"Media URL",value:o.FACE_MESH_MASK_TEXTURE_SOURCES.mediaUrl}],V=[{label:"Normal",value:o.FACE_MESH_BLEND_MODES.normal},{label:"Add",value:o.FACE_MESH_BLEND_MODES.add},{label:"Subtract",value:o.FACE_MESH_BLEND_MODES.subtract},{label:"Multiply",value:o.FACE_MESH_BLEND_MODES.multiply},{label:"Screen",value:o.FACE_MESH_BLEND_MODES.screen},{label:"Overlay",value:o.FACE_MESH_BLEND_MODES.overlay},{label:"Soft Light",value:o.FACE_MESH_BLEND_MODES.softLight},{label:"Hard Light",value:o.FACE_MESH_BLEND_MODES.hardLight},{label:"Lighten",value:o.FACE_MESH_BLEND_MODES.lighten},{label:"Darken",value:o.FACE_MESH_BLEND_MODES.darken},{label:"Difference",value:o.FACE_MESH_BLEND_MODES.difference},{label:"Exclusion",value:o.FACE_MESH_BLEND_MODES.exclusion}],K=`
+"use strict";const o=require("./FaceMeshRenderer-C5l6VLdO.cjs"),M=require("react/jsx-runtime"),S=require("react"),D=require("./index-DCiMbxC3.cjs"),y=require("./index-CyUUurQT.cjs"),T=require("@react-three/fiber"),U=require("three"),B=require("./selectors-CZLKT2Iv.cjs");function N(e){const a=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const t in e)if(t!=="default"){const r=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(a,t,r.get?r:{enumerable:!0,get:()=>e[t]})}}return a.default=e,Object.freeze(a)}const p=N(U),w={enabled:!1,strength:1,faceWidth:0,faceHeight:0,faceRoundness:0,midfaceHeight:0,foreheadHeight:0,foreheadWidth:0,cheekboneWidth:0,cheekWidth:0,cheekHollowness:0,midfaceDepth:0,scalpHeight:0,headCurve:0,faceTwist:0,faceSwirl:0,browDistance:0,browHeight:0,browDepth:0,eyeSize:0,leftEyeSize:0,rightEyeSize:0,eyeDistance:0,leftEyeX:0,rightEyeX:0,leftEyeY:0,rightEyeY:0,noseSize:0,noseLength:0,mouthWidth:0,mouthHeight:0,jawWidth:0,chinHeight:0},I={...w,enabled:!0,strength:1,faceWidth:-.08,faceHeight:.04,foreheadHeight:.04,cheekWidth:-.04,eyeSize:.08,eyeDistance:.03,noseSize:-.05,noseLength:.03,mouthWidth:.06,mouthHeight:.02,jawWidth:-.05,chinHeight:.03},X=[{label:"Wireframe",value:o.FACE_MESH_MATERIAL_TYPES.wireframe},{label:"Basic",value:o.FACE_MESH_MATERIAL_TYPES.basic},{label:"Standard",value:o.FACE_MESH_MATERIAL_TYPES.standard},{label:"Physical",value:o.FACE_MESH_MATERIAL_TYPES.physical},{label:"Toon",value:o.FACE_MESH_MATERIAL_TYPES.toon},{label:"Normal",value:o.FACE_MESH_MATERIAL_TYPES.normal},{label:"Matcap",value:o.FACE_MESH_MATERIAL_TYPES.matcap},{label:"Shader",value:o.FACE_MESH_MATERIAL_TYPES.shader}],W=[{label:"Original Face",value:o.FACE_MESH_SHADER_PRESETS.originalFace},{label:"Composite",value:o.FACE_MESH_SHADER_PRESETS.composite}],Y=[{label:"Front",value:o.FACE_MESH_SIDES.front},{label:"Back",value:o.FACE_MESH_SIDES.back},{label:"Double",value:o.FACE_MESH_SIDES.double}],j=[{label:"None",value:o.FACE_MESH_TEXTURE_MAPS.none},{label:"UV Map 1",value:o.FACE_MESH_TEXTURE_MAPS.canonical},{label:"UV Map 2",value:o.FACE_MESH_TEXTURE_MAPS.style2}],q=[{label:"None",value:o.FACE_MESH_ALPHA_MAPS.none},{label:"Default Mask",value:o.FACE_MESH_ALPHA_MAPS.canonical}],G=[{label:"Solid",value:o.FACE_MESH_MASK_TEXTURE_SOURCES.solid},{label:"Gradient",value:o.FACE_MESH_MASK_TEXTURE_SOURCES.gradient},{label:"Image URL",value:o.FACE_MESH_MASK_TEXTURE_SOURCES.imageUrl},{label:"Media URL",value:o.FACE_MESH_MASK_TEXTURE_SOURCES.mediaUrl}],V=[{label:"Normal",value:o.FACE_MESH_BLEND_MODES.normal},{label:"Add",value:o.FACE_MESH_BLEND_MODES.add},{label:"Subtract",value:o.FACE_MESH_BLEND_MODES.subtract},{label:"Multiply",value:o.FACE_MESH_BLEND_MODES.multiply},{label:"Screen",value:o.FACE_MESH_BLEND_MODES.screen},{label:"Overlay",value:o.FACE_MESH_BLEND_MODES.overlay},{label:"Soft Light",value:o.FACE_MESH_BLEND_MODES.softLight},{label:"Hard Light",value:o.FACE_MESH_BLEND_MODES.hardLight},{label:"Lighten",value:o.FACE_MESH_BLEND_MODES.lighten},{label:"Darken",value:o.FACE_MESH_BLEND_MODES.darken},{label:"Difference",value:o.FACE_MESH_BLEND_MODES.difference},{label:"Exclusion",value:o.FACE_MESH_BLEND_MODES.exclusion}],K=`
   varying vec2 vUv;
 
   void main() {

package/dist/{FaceRetouch-CMJbGThL.js → FaceRetouch-DwbKQJAN.js}

@@ -1,11 +1,11 @@
-import { F as p, a as _, b as w, c as A, d as y, e as u, f as k } from "./FaceMeshRenderer-DSCd1H55.js";
+import { F as p, a as _, b as w, c as A, d as y, e as u, f as k } from "./FaceMeshRenderer-wjAHrJzP.js";
 import { jsx as x, jsxs as W } from "react/jsx-runtime";
 import { useMemo as b, useEffect as P } from "react";
-import { X } from "./index-I4eF5TKT.js";
-import { u as I } from "./index-B-s4YbWu.js";
+import { X } from "./index-9dlAQAhy.js";
+import { u as I } from "./index-ByoNj0QP.js";
 import { useThree as Y, useFrame as V } from "@react-three/fiber";
 import * as g from "three";
-import { u as G } from "./selectors-ByKNTXeA.js";
+import { u as G } from "./selectors-B8H97CKA.js";
 const j = {
   enabled: !1,
   strength: 1,

package/dist/components/FaceMesh/FaceMeshRenderer.d.ts

@@ -1,4 +1,4 @@
-import { CanonicalFaceMeshRendererProps } from './canonical/CanonicalFaceMeshRenderer';
+import { CanonicalFaceMeshRendererProps, FaceMeshMaterialOverride } from './canonical/CanonicalFaceMeshRenderer';
 import { Transform3DSettings } from '../Transform3D';
 type SerializedFaceMeshRendererProps = Required<Pick<CanonicalFaceMeshRendererProps, "faceIndex" | "baseColor" | "opacity" | "materialType" | "shaderPreset" | "textureMap" | "alphaMap" | "alphaOpacity" | "side" | "blendMode" | "blendOpacity" | "showOverlayMask" | "showMouthMask" | "showLeftEyeMask" | "showRightEyeMask" | "showNoseMask" | "showLeftEyeGeometry" | "showRightEyeGeometry" | "showMouthGeometry" | "showNoseGeometry" | "maskTextureSource" | "maskSourceUrl" | "maskColor" | "maskOpacity" | "faceTextureUrl" | "faceTextureStyle2Url" | "faceAlphaMaskUrl" | "compositeShading" | "renderOrder" | "externalScale">>;
 export type FaceMeshRendererSettings = SerializedFaceMeshRendererProps & {
@@ -9,9 +9,17 @@ export type FaceMeshRendererSettings = SerializedFaceMeshRendererProps & {
 export declare const DEFAULT_FACE_MESH_TRANSFORM: Transform3DSettings;
 export declare const DEFAULT_FACE_MESH_RENDERER: FaceMeshRendererSettings;
 export declare const mapFaceMeshRendererSettingsToProps: (settings: FaceMeshRendererSettings) => CanonicalFaceMeshRendererProps;
+/** Combine serializable preset settings with an optional runtime-only override. */
+export declare const mapFaceMeshRendererProps: ({ materialOverride, value, }: Pick<FaceMeshRendererProps, "materialOverride" | "value">) => CanonicalFaceMeshRendererProps;
 export declare const resolveFaceMeshRendererSettings: (current: FaceMeshRendererSettings, patch: Partial<FaceMeshRendererSettings>) => FaceMeshRendererSettings;
-export declare const FaceMeshRenderer: ({ transform, value, }: {
+export type FaceMeshRendererProps = {
     transform?: Transform3DSettings;
     value: FaceMeshRendererSettings;
-}) => import("react/jsx-runtime").JSX.Element | null;
+    /**
+     * Runtime-only material node or factory. It takes precedence over serialized
+     * SDK presets and is intentionally excluded from FaceMeshRendererSettings.
+     */
+    materialOverride?: FaceMeshMaterialOverride;
+};
+export declare const FaceMeshRenderer: ({ transform, value, materialOverride }: FaceMeshRendererProps) => import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/components/FaceMesh/canonical/CanonicalFaceMeshRenderer.d.ts

@@ -53,11 +53,17 @@ export type CanonicalFaceMeshRendererProps = {
      */
     meshUrl?: string;
     /** Optional material override, rendered for every visible geometry group. */
-    materialOverride?: ReactNode | ((context: {
-        cameraTexture: THREE.Texture | null;
-        geometryKey: CanonicalFaceMeshGeometryKey;
-    }) => ReactNode);
+    materialOverride?: FaceMeshMaterialOverride;
 };
+export type FaceMeshMaterialOverrideContext = {
+    cameraTexture: THREE.Texture | null;
+    geometryKey: CanonicalFaceMeshGeometryKey;
+};
+/**
+ * Runtime-only material escape hatch. Preset settings remain serializable;
+ * pass a material node or factory here from JSX or a scene host instead.
+ */
+export type FaceMeshMaterialOverride = ReactNode | ((context: FaceMeshMaterialOverrideContext) => ReactNode);
 /**
  * @deprecated Use `FaceMeshRenderer` for scene-object/editor integrations.
  * This remains as the low-level canonical mesh renderer for existing imports.