talking-head-studio 0.4.10 → 0.4.12

package/dist/TalkingHead.d.ts

@@ -1,6 +1,8 @@
 import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
-export type TalkingHeadMood = 'neutral' | 'happy' | 'sad' | 'angry' | 'excited' | 'thinking' | 'concerned' | 'surprised';
+export type TalkingHeadMood = 'neutral' | 'happy' | 'sad' | 'angry' | 'fear' | 'disgust' | 'love' | 'sleep' | 'excited' | 'thinking' | 'concerned' | 'surprised';
+import type { AgentVisemePayload, OculusViseme, VisemeCue } from './core/avatar/visemes';
+import type { MotionKey, TalkingHeadGesture, TalkingHeadPose } from './core/avatar/motion';
 export type TalkingHeadLoadingStage = 'booting' | 'fetching_model' | 'loading_avatar' | 'loading_fallback' | 'ready';
 export interface TalkingHeadLoadingState {
     stage: TalkingHeadLoadingStage;
@@ -9,36 +11,20 @@ export interface TalkingHeadLoadingState {
 /**
  * Standard viseme keys supported by the avatar.
  * Use with sendViseme() from your TTS viseme callbacks.
+ * @deprecated Use OculusViseme from @yourplatform/avatar/core/avatar/visemes
  */
-export type TalkingHeadViseme = 'sil' | 'PP' | 'FF' | 'TH' | 'DD' | 'kk' | 'CH' | 'SS' | 'nn' | 'RR' | 'aa' | 'ee' | 'ih' | 'oh' | 'ou';
-/** Rhubarb mouth shape cue (Preston Blair set: A-H, X) */
-export interface TalkingHeadVisemeCue {
-    startMs: number;
-    endMs: number;
-    viseme: 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'X';
-}
+export type TalkingHeadViseme = OculusViseme;
+/**
+ * Rhubarb mouth shape cue (Preston Blair set: A-H, X)
+ * @deprecated Use VisemeCue from @yourplatform/avatar/core/avatar/visemes
+ */
+export type TalkingHeadVisemeCue = VisemeCue;
 /**
  * A full viseme schedule from the Rhubarb sidecar endpoint.
  * Pass to scheduleVisemes() when agent_visemes arrives on the data channel.
+ * @deprecated Use AgentVisemePayload from @yourplatform/avatar/core/avatar/visemes
  */
-export interface TalkingHeadVisemeSchedule {
-    /** Matches X-TTS-Request-Id / agent_visemes.requestId */
-    requestId?: string;
-    /**
-     * Wall-clock ms at which the TTS request was fired (agent side).
-     * Used as the scheduling anchor plus AUDIO_PIPELINE_DELAY_MS.
-     */
-    startedAtMs?: number;
-    /**
-     * Wall-clock ms at which audio actually began playing in the speaker.
-     * When present, used directly as the scheduling anchor with no additional
-     * pipeline offset — more accurate than startedAtMs on fast connections.
-     * Stamp this from the LiveKit onAudioPlaybackStarted callback if available.
-     */
-    audioStartedAtMs?: number;
-    durationMs?: number;
-    cues: TalkingHeadVisemeCue[];
-}
+export type TalkingHeadVisemeSchedule = AgentVisemePayload;
 export interface TalkingHeadAccessory {
     id: string;
     url: string;
@@ -66,6 +52,9 @@ export interface TalkingHeadProps {
     /** Base URL for vendored assets. When set, replaces all cdn.jsdelivr.net references. */
     vendorBaseUrl?: string | null;
 }
+/** @deprecated Use AvatarPlayerProps */
+export type TalkingHeadPropsAlias = TalkingHeadProps;
+export type AvatarPlayerProps = TalkingHeadProps;
 export interface TalkingHeadRef {
     sendAmplitude: (amplitude: number) => void;
     /**
@@ -100,7 +89,34 @@ export interface TalkingHeadRef {
     setSkinColor: (color: string) => void;
     setEyeColor: (color: string) => void;
     setAccessories: (accessories: TalkingHeadAccessory[]) => void;
-    /** Dispatch a named motion/gesture to the avatar (e.g. 'wave_right', 'dance_idle'). */
-    dispatchMotion: (name: string) => void;
+    /** Play a procedural motion (e.g. 'attack', 'defend', 'groove'). */
+    dispatchMotion(name: MotionKey): void;
+    dispatchMotion(name: string): void;
+    /** Stop the current procedural motion and return to rest. */
+    stopMotion: () => void;
+    /** Play an upstream TalkingHead hand gesture (e.g. 'thumbup'). */
+    playGesture: (name: TalkingHeadGesture | string, opts?: {
+        dur?: number;
+        mirror?: boolean;
+        ms?: number;
+    }) => void;
+    /** Stop the current gesture, easing out over `ms`. */
+    stopGesture: (ms?: number) => void;
+    /** Strike a pose — a built-in template name (e.g. 'oneknee') or a pose-file URL. */
+    playPose: (urlOrTemplate: TalkingHeadPose | string, dur?: number) => void;
+    /** Release the current pose and return to the default stance. */
+    stopPose: () => void;
+    /** Play a full body animation from a GLB/FBX URL (e.g. a combat move). */
+    playAnimation: (url: string, opts?: {
+        dur?: number;
+        index?: number;
+    }) => void;
+    /** Stop the current body animation. */
+    stopAnimation: () => void;
+    /** Turn head/eyes toward viewport coordinates (px), easing over `ms`. */
+    lookAt: (x: number, y: number, ms?: number) => void;
 }
+/** @deprecated Use AvatarPlayerRef */
+export type TalkingHeadRefAlias = TalkingHeadRef;
+export type AvatarPlayerRef = TalkingHeadRef;
 export declare const TalkingHead: React.ForwardRefExoticComponent<TalkingHeadProps & React.RefAttributes<TalkingHeadRef>>;

package/dist/TalkingHead.js

@@ -6,6 +6,7 @@ const react_1 = require("react");
 const react_native_1 = require("react-native");
 const react_native_webview_1 = require("react-native-webview");
 const html_1 = require("./html");
+const shouldLogDebugMessages = __DEV__;
 exports.TalkingHead = (0, react_1.forwardRef)(({ avatarUrl, authToken, mood = 'neutral', cameraView = 'upper', cameraDistance = -0.5, hairColor, skinColor, eyeColor, accessories, onLoadingChange, onReady, onError, onAvatarState, onVoiceMood, style, vendorBaseUrl, }, ref) => {
     const webViewRef = (0, react_1.useRef)(null);
     const readyRef = (0, react_1.useRef)(false);
@@ -129,6 +130,14 @@ exports.TalkingHead = (0, react_1.forwardRef)(({ avatarUrl, authToken, mood = 'n
             }
         },
         dispatchMotion: (name) => post({ type: 'motion', name }),
+        stopMotion: () => post({ type: 'stop_motion' }),
+        playGesture: (name, opts) => post({ type: 'gesture', name, dur: opts?.dur, mirror: opts?.mirror, ms: opts?.ms }),
+        stopGesture: (ms) => post({ type: 'stop_gesture', ms }),
+        playPose: (url, dur) => post({ type: 'pose', url, dur }),
+        stopPose: () => post({ type: 'stop_pose' }),
+        playAnimation: (url, opts) => post({ type: 'animation', url, dur: opts?.dur, index: opts?.index }),
+        stopAnimation: () => post({ type: 'stop_animation' }),
+        lookAt: (x, y, ms) => post({ type: 'look_at', x, y, ms }),
     }), [post]);
     // Sync mood via postMessage only — never causes a WebView reload
     (0, react_1.useEffect)(() => {
@@ -231,7 +240,7 @@ exports.TalkingHead = (0, react_1.forwardRef)(({ avatarUrl, authToken, mood = 'n
             else if (msg.type === 'voiceMood') {
                 onVoiceMoodRef.current?.(msg.mood);
             }
-            else if (msg.type === 'log') {
+            else if (msg.type === 'log' && shouldLogDebugMessages) {
                 console.log('[TalkingHead]', msg.message);
             }
         }
@@ -249,7 +258,17 @@ exports.TalkingHead = (0, react_1.forwardRef)(({ avatarUrl, authToken, mood = 'n
         const { statusCode, description, url } = event.nativeEvent;
         onErrorRef.current?.(`[http ${statusCode}] ${description || url || 'Avatar request failed'}`);
     }, []);
-    return ((0, jsx_runtime_1.jsx)(react_native_1.View, { style: [styles.container, style], children: (0, jsx_runtime_1.jsx)(react_native_webview_1.WebView, { ref: webViewRef, source: { html, baseUrl: webViewBaseUrl }, style: styles.webview, javaScriptEnabled: true, domStorageEnabled: true, allowsInlineMediaPlayback: true, mediaPlaybackRequiresUserAction: false, onMessage: onMessage, onError: handleWebViewError, onHttpError: handleWebViewHttpError, onLoadStart: () => console.log('[TalkingHead] WebView load start'), onLoadEnd: () => console.log('[TalkingHead] WebView load end'), onLoadProgress: (event) => console.log('[TalkingHead] WebView progress', event.nativeEvent.progress), originWhitelist: ['*'], allowFileAccess: true, allowFileAccessFromFileURLs: true, allowUniversalAccessFromFileURLs: true, mixedContentMode: "always" }, webViewKey) }));
+    return ((0, jsx_runtime_1.jsx)(react_native_1.View, { style: [styles.container, style], children: (0, jsx_runtime_1.jsx)(react_native_webview_1.WebView, { ref: webViewRef, source: { html, baseUrl: webViewBaseUrl }, style: styles.webview, javaScriptEnabled: true, domStorageEnabled: true, allowsInlineMediaPlayback: true, mediaPlaybackRequiresUserAction: false, onMessage: onMessage, onError: handleWebViewError, onHttpError: handleWebViewHttpError, onLoadStart: () => {
+                if (shouldLogDebugMessages)
+                    console.log('[TalkingHead] WebView load start');
+            }, onLoadEnd: () => {
+                if (shouldLogDebugMessages)
+                    console.log('[TalkingHead] WebView load end');
+            }, onLoadProgress: (event) => {
+                if (shouldLogDebugMessages) {
+                    console.log('[TalkingHead] WebView progress', event.nativeEvent.progress);
+                }
+            }, originWhitelist: ['*'], allowFileAccess: true, allowFileAccessFromFileURLs: true, allowUniversalAccessFromFileURLs: true, mixedContentMode: "always" }, webViewKey) }));
 });
 exports.TalkingHead.displayName = 'TalkingHead';
 const styles = react_native_1.StyleSheet.create({

package/dist/TalkingHead.web.d.ts

@@ -1,7 +1,8 @@
 import React from 'react';
-import type { TalkingHeadLoadingState, TalkingHeadVisemeCue, TalkingHeadVisemeSchedule } from './TalkingHead';
-export type { TalkingHeadLoadingState, TalkingHeadVisemeCue, TalkingHeadVisemeSchedule };
-export type TalkingHeadMood = 'neutral' | 'happy' | 'sad' | 'angry' | 'excited' | 'thinking' | 'concerned' | 'surprised';
+import type { TalkingHeadLoadingState, TalkingHeadLoadingStage, TalkingHeadViseme, TalkingHeadVisemeCue, TalkingHeadVisemeSchedule } from './TalkingHead';
+import type { MotionKey, TalkingHeadGesture, TalkingHeadPose } from './core/avatar/motion';
+export type { TalkingHeadLoadingStage, TalkingHeadLoadingState, TalkingHeadViseme, TalkingHeadVisemeCue, TalkingHeadVisemeSchedule, };
+export type TalkingHeadMood = 'neutral' | 'happy' | 'sad' | 'angry' | 'fear' | 'disgust' | 'love' | 'sleep' | 'excited' | 'thinking' | 'concerned' | 'surprised';
 export interface TalkingHeadAccessory {
     id: string;
     url: string;
@@ -26,8 +27,12 @@ export interface TalkingHeadProps {
     onAvatarState?: (state: string) => void;
     style?: React.CSSProperties;
 }
+/** @deprecated Use AvatarPlayerProps */
+export type TalkingHeadPropsAlias = TalkingHeadProps;
+export type AvatarPlayerProps = TalkingHeadProps;
 export interface TalkingHeadRef {
     sendAmplitude: (amplitude: number) => void;
+    sendViseme: (viseme: TalkingHeadViseme, weight?: number) => void;
     scheduleVisemes: (schedule: TalkingHeadVisemeSchedule) => void;
     clearVisemes: () => void;
     setMood: (mood: TalkingHeadMood) => void;
@@ -35,6 +40,34 @@ export interface TalkingHeadRef {
     setSkinColor: (color: string) => void;
     setEyeColor: (color: string) => void;
     setAccessories: (accessories: TalkingHeadAccessory[]) => void;
-    dispatchMotion: (name: string) => void;
+    /** Play a procedural motion (e.g. 'attack', 'defend', 'groove'). */
+    dispatchMotion(name: MotionKey): void;
+    dispatchMotion(name: string): void;
+    /** Stop the current procedural motion and return to rest. */
+    stopMotion: () => void;
+    /** Play an upstream TalkingHead hand gesture (e.g. 'thumbup'). */
+    playGesture: (name: TalkingHeadGesture | string, opts?: {
+        dur?: number;
+        mirror?: boolean;
+        ms?: number;
+    }) => void;
+    /** Stop the current gesture, easing out over `ms`. */
+    stopGesture: (ms?: number) => void;
+    /** Strike a pose — a built-in template name (e.g. 'oneknee') or a pose-file URL. */
+    playPose: (urlOrTemplate: TalkingHeadPose | string, dur?: number) => void;
+    /** Release the current pose and return to the default stance. */
+    stopPose: () => void;
+    /** Play a full body animation from a GLB/FBX URL (e.g. a combat move). */
+    playAnimation: (url: string, opts?: {
+        dur?: number;
+        index?: number;
+    }) => void;
+    /** Stop the current body animation. */
+    stopAnimation: () => void;
+    /** Turn head/eyes toward viewport coordinates (px), easing over `ms`. */
+    lookAt: (x: number, y: number, ms?: number) => void;
 }
+/** @deprecated Use AvatarPlayerRef */
+export type TalkingHeadRefAlias = TalkingHeadRef;
+export type AvatarPlayerRef = TalkingHeadRef;
 export declare const TalkingHead: React.ForwardRefExoticComponent<TalkingHeadProps & React.RefAttributes<TalkingHeadRef>>;

package/dist/TalkingHead.web.js

@@ -15,18 +15,29 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TalkingHead = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = __importStar(require("react"));
 const html_1 = require("./html");
+const shouldLogDebugMessages = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production';
 const containerStyle = {
     overflow: 'hidden',
     borderRadius: 12,
@@ -69,6 +80,7 @@ exports.TalkingHead = (0, react_1.forwardRef)(({ avatarUrl, authToken, mood = 'n
     }, []);
     (0, react_1.useImperativeHandle)(ref, () => ({
         sendAmplitude: (amplitude) => post({ type: 'amplitude', value: amplitude }),
+        sendViseme: (viseme, weight = 1.0) => post({ type: 'viseme', viseme, weight }),
         scheduleVisemes: (schedule) => post({ type: 'schedule_visemes', schedule }),
         clearVisemes: () => post({ type: 'clear_visemes' }),
         setMood: (nextMood) => {
@@ -98,6 +110,14 @@ exports.TalkingHead = (0, react_1.forwardRef)(({ avatarUrl, authToken, mood = 'n
             }
         },
         dispatchMotion: (name) => post({ type: 'motion', name }),
+        stopMotion: () => post({ type: 'stop_motion' }),
+        playGesture: (name, opts) => post({ type: 'gesture', name, dur: opts?.dur, mirror: opts?.mirror, ms: opts?.ms }),
+        stopGesture: (ms) => post({ type: 'stop_gesture', ms }),
+        playPose: (url, dur) => post({ type: 'pose', url, dur }),
+        stopPose: () => post({ type: 'stop_pose' }),
+        playAnimation: (url, opts) => post({ type: 'animation', url, dur: opts?.dur, index: opts?.index }),
+        stopAnimation: () => post({ type: 'stop_animation' }),
+        lookAt: (x, y, ms) => post({ type: 'look_at', x, y, ms }),
     }), [post]);
     (0, react_1.useEffect)(() => {
         pendingMoodRef.current = mood;
@@ -192,7 +212,7 @@ exports.TalkingHead = (0, react_1.forwardRef)(({ avatarUrl, authToken, mood = 'n
                 else if (msg.type === 'avatarState') {
                     onAvatarStateRef.current?.(msg.state);
                 }
-                else if (msg.type === 'log') {
+                else if (msg.type === 'log' && shouldLogDebugMessages) {
                     console.log('[TalkingHead]', msg.message);
                 }
             }

package/dist/TalkingHeadVisualization.d.ts

@@ -1,3 +1,4 @@
+import './wgpu/blobShim';
 import React from 'react';
 import { ViewStyle, StyleProp } from 'react-native';
 import { type TalkingHeadMood, type TalkingHeadAccessory, type TalkingHeadViseme, type TalkingHeadVisemeSchedule } from './TalkingHead';
@@ -27,6 +28,27 @@ export interface TalkingHeadVisualizationRef {
     clearVisemes: () => void;
     /** Trigger a named motion on the avatar (e.g. 'celebrate', 'groove', 'wave') */
     playMotion: (name: string) => void;
+    /** Stop the current procedural motion and return to rest. */
+    stopMotion: () => void;
+    /** Play an upstream TalkingHead gesture or native procedural fallback. */
+    playGesture: (name: string, opts?: {
+        dur?: number;
+        mirror?: boolean;
+        ms?: number;
+    }) => void;
+    /** Stop the current gesture. */
+    stopGesture: (ms?: number) => void;
+    /** Strike a pose by built-in name or pose URL. */
+    playPose: (name: string, dur?: number) => void;
+    /** Release the current pose and return to rest. */
+    stopPose: () => void;
+    /** Play a hosted animation clip on renderers that support it. */
+    playAnimation: (url: string, opts?: {
+        dur?: number;
+        index?: number;
+    }) => void;
+    /** Stop the current hosted animation clip. */
+    stopAnimation: () => void;
 }
 /**
  * TalkingHeadVisualization — optimized component for rendering the 3D avatar.

package/dist/TalkingHeadVisualization.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TalkingHeadVisualization = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+// IMPORTANT: blobShim must be first — installs Blob+createObjectURL patch
+// before @react-three/fiber's polyfills() runs.
+require("./wgpu/blobShim");
 /* eslint-disable @typescript-eslint/no-unused-expressions */
 const react_1 = require("react");
 const react_native_1 = require("react-native");
@@ -60,7 +63,7 @@ exports.TalkingHeadVisualization = (0, react_1.forwardRef)(({ style, avatarUrl,
             setFallbackUrl(_fallbackDataUri);
             return;
         }
-        getFallbackAvatarUrl().then((u) => u && setFallbackUrl(u));
+        void getFallbackAvatarUrl().then((u) => u && setFallbackUrl(u));
     }, []);
     const [mood, setMood] = (0, react_1.useState)(initialMood);
     const [isAvatarReady, setIsAvatarReady] = (0, react_1.useState)(false);
@@ -98,7 +101,7 @@ exports.TalkingHeadVisualization = (0, react_1.forwardRef)(({ style, avatarUrl,
             cues: pendingSchedule.cues.length,
             ageMs,
         });
-        activeAvatar()?.scheduleVisemes(pendingSchedule);
+        activeAvatar()?.scheduleVisemes?.(pendingSchedule);
         onVisemeScheduleApplied?.({
             requestId: pendingSchedule.requestId ?? null,
             appliedAtMs: Date.now(),
@@ -108,10 +111,24 @@ exports.TalkingHeadVisualization = (0, react_1.forwardRef)(({ style, avatarUrl,
     }, [onVisemeScheduleApplied, activeAvatar]);
     (0, react_1.useImperativeHandle)(ref, () => ({
         setMood: (m) => setMood(m),
-        sendAmplitude: (a) => activeAvatar()?.sendAmplitude(a),
-        sendViseme: (viseme, weight) => activeAvatar()?.sendViseme(viseme, weight),
-        clearVisemes: () => activeAvatar()?.clearVisemes(),
-        playMotion: (name) => avatarRef.current?.dispatchMotion(name),
+        sendAmplitude: (a) => activeAvatar()?.sendAmplitude?.(a),
+        sendViseme: (viseme, weight) => activeAvatar()?.sendViseme?.(viseme, weight),
+        clearVisemes: () => activeAvatar()?.clearVisemes?.(),
+        playMotion: (name) => {
+            const avatar = activeAvatar();
+            if (avatar?.playMotion) {
+                avatar.playMotion(name);
+                return;
+            }
+            avatar?.dispatchMotion?.(name);
+        },
+        stopMotion: () => activeAvatar()?.stopMotion?.(),
+        playGesture: (name, opts) => activeAvatar()?.playGesture?.(name, opts),
+        stopGesture: (ms) => activeAvatar()?.stopGesture?.(ms),
+        playPose: (name, dur) => activeAvatar()?.playPose?.(name, dur),
+        stopPose: () => activeAvatar()?.stopPose?.(),
+        playAnimation: (url, opts) => activeAvatar()?.playAnimation?.(url, opts),
+        stopAnimation: () => activeAvatar()?.stopAnimation?.(),
         scheduleVisemes: (schedule) => {
             const scheduleKey = `${schedule.requestId ?? 'anonymous'}:${schedule.startedAtMs ?? 0}`;
             if (lastScheduledVisemeKeyRef.current === scheduleKey)
@@ -119,7 +136,7 @@ exports.TalkingHeadVisualization = (0, react_1.forwardRef)(({ style, avatarUrl,
             const av = activeAvatar();
             // WgpuAvatar buffers pending schedules internally — no ready gate needed.
             // WebView (avatarRef) still needs the ready gate.
-            if (!av || (!wgpuRef.current && !isAvatarReady)) {
+            if (!av?.scheduleVisemes || (!wgpuRef.current && !isAvatarReady)) {
                 pendingVisemeScheduleRef.current = schedule;
                 return;
             }
@@ -140,8 +157,11 @@ exports.TalkingHeadVisualization = (0, react_1.forwardRef)(({ style, avatarUrl,
         lastScheduledVisemeKeyRef.current = null;
     }, [avatarUrl]);
     const handleError = (0, react_1.useCallback)((message) => {
-        console.warn('[TalkingHeadVisualization] Avatar load failed, switching to fallback:', message);
+        console.warn('[TalkingHeadVisualization] Avatar error:', message);
         setAvatarError(message);
+        // Only fall back to local GLB for hard load failures, not morph-target warnings
+        if (message.includes('morph') || message.includes('No mesh'))
+            return;
         setUseFallback(true);
     }, []);
     // Effective avatar URL: use remote if available, fallback GLB if error or missing
@@ -169,7 +189,7 @@ exports.TalkingHeadVisualization = (0, react_1.forwardRef)(({ style, avatarUrl,
             ready: isAvatarReady,
         });
         const av = activeAvatar();
-        if (!av || (!wgpuRef.current && !isAvatarReady)) {
+        if (!av?.scheduleVisemes || (!wgpuRef.current && !isAvatarReady)) {
             pendingVisemeScheduleRef.current = visemeSchedule;
             return;
         }
@@ -193,7 +213,7 @@ exports.TalkingHeadVisualization = (0, react_1.forwardRef)(({ style, avatarUrl,
     if (!effectiveAvatarUrl) {
         return ((0, jsx_runtime_1.jsx)(react_native_1.View, { style: [style, styles.placeholder] }));
     }
-    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: [style, styles.container], pointerEvents: "box-none", children: [(0, jsx_runtime_1.jsx)(TalkingHead_1.TalkingHead, { ref: avatarRef, avatarUrl: effectiveAvatarUrl, authToken: authToken, cameraView: cameraView, cameraDistance: cameraDistance, accessories: accessories, mood: mood, onLoadingChange: handleLoadingChange, onReady: handleReady, onError: handleError, onVoiceMood: onVoiceMood, style: react_native_1.StyleSheet.absoluteFill, vendorBaseUrl: vendorBaseUrl }), !isAvatarReady && ((0, jsx_runtime_1.jsx)(react_native_1.View, { testID: "talking-head-loading", style: styles.loadingOverlay, pointerEvents: "none", children: (0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.loadingCard, children: [(0, jsx_runtime_1.jsx)(react_native_1.View, { style: styles.loadingBadge, children: (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.loadingBadgeText, children: "AVATAR" }) }), (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.loadingTitle, children: avatarError ? 'Avatar failed to load' : getLoadingLabel(loadingState.stage) }), avatarError ? ((0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.loadingHint, children: avatarError })) : typeof loadingState.progress === 'number' ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_native_1.Text, { style: styles.loadingPercent, children: [loadingState.progress, "%"] }), (0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.progressTrack, children: [(0, jsx_runtime_1.jsx)(react_native_1.View, { style: { flex: Math.max(6, loadingState.progress ?? 0), height: '100%', borderRadius: 999, backgroundColor: '#5eead4' } }), (0, jsx_runtime_1.jsx)(react_native_1.View, { style: { flex: 100 - Math.max(6, loadingState.progress ?? 0) } })] })] })) : ((0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.loadingHint, children: "Preparing the avatar scene\u2026" }))] }) }))] }));
+    return ((0, jsx_runtime_1.jsxs)(react_native_1.View, { style: [style, styles.container], pointerEvents: "box-none", children: [(0, jsx_runtime_1.jsx)(TalkingHead_1.TalkingHead, { ref: avatarRef, avatarUrl: effectiveAvatarUrl, authToken: authToken, cameraView: cameraView, cameraDistance: cameraDistance, accessories: accessories, mood: mood, onLoadingChange: handleLoadingChange, onReady: handleReady, onError: handleError, onVoiceMood: onVoiceMood, style: react_native_1.StyleSheet.absoluteFillObject, vendorBaseUrl: vendorBaseUrl }), !isAvatarReady && ((0, jsx_runtime_1.jsx)(react_native_1.View, { testID: "talking-head-loading", style: styles.loadingOverlay, pointerEvents: "none", children: (0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.loadingCard, children: [(0, jsx_runtime_1.jsx)(react_native_1.View, { style: styles.loadingBadge, children: (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.loadingBadgeText, children: "AVATAR" }) }), (0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.loadingTitle, children: avatarError ? 'Avatar failed to load' : getLoadingLabel(loadingState.stage) }), avatarError ? ((0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.loadingHint, children: avatarError })) : typeof loadingState.progress === 'number' ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_native_1.Text, { style: styles.loadingPercent, children: [loadingState.progress, "%"] }), (0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.progressTrack, children: [(0, jsx_runtime_1.jsx)(react_native_1.View, { style: { flex: Math.max(6, loadingState.progress ?? 0), height: '100%', borderRadius: 999, backgroundColor: '#5eead4' } }), (0, jsx_runtime_1.jsx)(react_native_1.View, { style: { flex: 100 - Math.max(6, loadingState.progress ?? 0) } })] })] })) : ((0, jsx_runtime_1.jsx)(react_native_1.Text, { style: styles.loadingHint, children: "Preparing the avatar scene\u2026" }))] }) }))] }));
 });
 exports.TalkingHeadVisualization.displayName = 'TalkingHeadVisualization';
 const styles = react_native_1.StyleSheet.create({

package/dist/api/studioApi.d.ts

@@ -9,7 +9,18 @@ export declare function getMyAvatars(): Promise<Avatar[]>;
 export declare function getAvatar(id: string): Promise<Avatar>;
 export declare function updateAvatar(id: string, data: AvatarUpdate): Promise<Avatar>;
 export declare function deleteAvatar(id: string): Promise<void>;
-export declare function createAvatar(fileUri: string, name: string, description?: string): Promise<Avatar>;
+export interface CreateAvatarOptions {
+    /** Sketchfab model uid this avatar was imported from. */
+    sketchfabUid?: string;
+    /** Whether the GLB has morph targets (enables real lipsync). */
+    sketchfabHasMorphs?: boolean;
+}
+export declare function createAvatar(fileUri: string, name: string, description?: string, options?: CreateAvatarOptions): Promise<Avatar>;
+/**
+ * Sketchfab uids that previously imported with working morph targets.
+ * Used to pin "verified" models to the top of search results.
+ */
+export declare function getVerifiedSketchfabUids(): Promise<string[]>;
 export declare function getPublicAvatars(): Promise<PublicAvatar[]>;
 export declare function getVoiceProfileSamples(profileId: string): Promise<ProfileSample[]>;
 export declare function getVoiceProfiles(): Promise<VoiceProfile[]>;

package/dist/api/studioApi.js

@@ -1,21 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadVoiceSample = exports.createVoiceProfile = exports.assetFileUrl = exports.suggestPlacement = exports.deleteAsset = exports.uploadAsset = exports.getAsset = exports.listAssets = exports.thumbnailHeaders = exports.avatarAnimatedThumbnailUrl = exports.avatarThumbnailUrl = exports.avatarFileUrl = exports.removeDefaultVoice = exports.setDefaultVoice = exports.getVoiceProfiles = exports.getVoiceProfileSamples = exports.getPublicAvatars = exports.createAvatar = exports.deleteAvatar = exports.updateAvatar = exports.getAvatar = exports.getMyAvatars = exports.studioFetch = exports.getToken = exports.configureAvatarApi = void 0;
+exports.configureAvatarApi = configureAvatarApi;
+exports.getToken = getToken;
+exports.studioFetch = studioFetch;
+exports.getMyAvatars = getMyAvatars;
+exports.getAvatar = getAvatar;
+exports.updateAvatar = updateAvatar;
+exports.deleteAvatar = deleteAvatar;
+exports.createAvatar = createAvatar;
+exports.getVerifiedSketchfabUids = getVerifiedSketchfabUids;
+exports.getPublicAvatars = getPublicAvatars;
+exports.getVoiceProfileSamples = getVoiceProfileSamples;
+exports.getVoiceProfiles = getVoiceProfiles;
+exports.setDefaultVoice = setDefaultVoice;
+exports.removeDefaultVoice = removeDefaultVoice;
+exports.avatarFileUrl = avatarFileUrl;
+exports.avatarThumbnailUrl = avatarThumbnailUrl;
+exports.avatarAnimatedThumbnailUrl = avatarAnimatedThumbnailUrl;
+exports.thumbnailHeaders = thumbnailHeaders;
+exports.listAssets = listAssets;
+exports.getAsset = getAsset;
+exports.uploadAsset = uploadAsset;
+exports.deleteAsset = deleteAsset;
+exports.suggestPlacement = suggestPlacement;
+exports.assetFileUrl = assetFileUrl;
+exports.createVoiceProfile = createVoiceProfile;
+exports.uploadVoiceSample = uploadVoiceSample;
 // ---------------------------------------------------------------------------
 // Injectable configuration
 // ---------------------------------------------------------------------------
-let _baseUrl = process.env.EXPO_PUBLIC_BACKEND_URL ?? '';
+let _baseUrl = typeof process !== 'undefined'
+    ? process.env.EXPO_PUBLIC_BACKEND_URL ?? ''
+    : '';
 let _getToken = null;
 function configureAvatarApi(opts) {
     if (opts.baseUrl !== undefined)
         _baseUrl = opts.baseUrl;
     _getToken = opts.getToken;
 }
-exports.configureAvatarApi = configureAvatarApi;
 async function getToken() {
     return _getToken ? _getToken() : null;
 }
-exports.getToken = getToken;
 // ---------------------------------------------------------------------------
 // Core fetch wrappers
 // ---------------------------------------------------------------------------
@@ -48,7 +73,6 @@ async function studioFetch(path, options) {
     }
     return res.json();
 }
-exports.studioFetch = studioFetch;
 /** POST/PUT with FormData, sharing auth token logic. */
 async function studioFetchForm(path, method, formData) {
     const token = await getToken();
@@ -76,11 +100,9 @@ async function studioFetchForm(path, method, formData) {
 function getMyAvatars() {
     return studioFetch('/v1/avatars');
 }
-exports.getMyAvatars = getMyAvatars;
 function getAvatar(id) {
     return studioFetch(`/v1/avatars/${id}`);
 }
-exports.getAvatar = getAvatar;
 function updateAvatar(id, data) {
     return studioFetch(`/v1/avatars/${id}`, {
         method: 'PATCH',
@@ -88,12 +110,10 @@ function updateAvatar(id, data) {
         body: JSON.stringify(data),
     });
 }
-exports.updateAvatar = updateAvatar;
 function deleteAvatar(id) {
     return studioFetch(`/v1/avatars/${id}`, { method: 'DELETE' });
 }
-exports.deleteAvatar = deleteAvatar;
-async function createAvatar(fileUri, name, description) {
+async function createAvatar(fileUri, name, description, options) {
     const formData = new FormData();
     formData.append('file', {
         uri: fileUri,
@@ -104,24 +124,31 @@ async function createAvatar(fileUri, name, description) {
     if (description) {
         formData.append('description', description);
     }
+    if (options?.sketchfabUid) {
+        formData.append('sketchfab_uid', options.sketchfabUid);
+        formData.append('sketchfab_has_morphs', options.sketchfabHasMorphs ? 'true' : 'false');
+    }
     return studioFetchForm('/v1/avatars', 'POST', formData);
 }
-exports.createAvatar = createAvatar;
+/**
+ * Sketchfab uids that previously imported with working morph targets.
+ * Used to pin "verified" models to the top of search results.
+ */
+function getVerifiedSketchfabUids() {
+    return studioFetch('/v1/sketchfab/verified').then((r) => r.uids);
+}
 function getPublicAvatars() {
     return studioFetch('/v1/avatars/public');
 }
-exports.getPublicAvatars = getPublicAvatars;
 // ---------------------------------------------------------------------------
 // Voice profile endpoints
 // ---------------------------------------------------------------------------
 function getVoiceProfileSamples(profileId) {
     return studioFetch(`/profiles/${profileId}/samples`);
 }
-exports.getVoiceProfileSamples = getVoiceProfileSamples;
 function getVoiceProfiles() {
     return studioFetch('/profiles');
 }
-exports.getVoiceProfiles = getVoiceProfiles;
 function setDefaultVoice(avatarId, profileId) {
     return studioFetch(`/v1/avatars/${avatarId}/default-voice`, {
         method: 'PUT',
@@ -129,13 +156,11 @@ function setDefaultVoice(avatarId, profileId) {
         body: JSON.stringify({ profile_id: profileId }),
     });
 }
-exports.setDefaultVoice = setDefaultVoice;
 function removeDefaultVoice(avatarId) {
     return studioFetch(`/v1/avatars/${avatarId}/default-voice`, {
         method: 'DELETE',
     });
 }
-exports.removeDefaultVoice = removeDefaultVoice;
 // ---------------------------------------------------------------------------
 // URL helpers
 // ---------------------------------------------------------------------------
@@ -143,27 +168,23 @@ function avatarFileUrl(avatar) {
     const base = `${_baseUrl}${avatar.url}`;
     return avatar.updated_at ? `${base}?v=${encodeURIComponent(avatar.updated_at)}` : base;
 }
-exports.avatarFileUrl = avatarFileUrl;
 function avatarThumbnailUrl(avatar) {
     const url = avatar.thumbnail_url || avatar.animated_thumbnail_url;
     if (!url)
         return null;
     return `${_baseUrl}${url}`;
 }
-exports.avatarThumbnailUrl = avatarThumbnailUrl;
 function avatarAnimatedThumbnailUrl(avatar) {
     if (!avatar.animated_thumbnail_url)
         return null;
     return `${_baseUrl}${avatar.animated_thumbnail_url}`;
 }
-exports.avatarAnimatedThumbnailUrl = avatarAnimatedThumbnailUrl;
 async function thumbnailHeaders() {
     const token = await getToken();
     if (!token)
         return {};
     return { Authorization: `Bearer ${token}` };
 }
-exports.thumbnailHeaders = thumbnailHeaders;
 // ---------------------------------------------------------------------------
 // Wearable Asset endpoints
 // ---------------------------------------------------------------------------
@@ -171,11 +192,9 @@ function listAssets(category) {
     const query = category ? `?category=${encodeURIComponent(category)}` : '';
     return studioFetch(`/v1/assets${query}`);
 }
-exports.listAssets = listAssets;
 function getAsset(id) {
     return studioFetch(`/v1/assets/${id}`);
 }
-exports.getAsset = getAsset;
 async function uploadAsset(fileUri, meta) {
     const formData = new FormData();
     formData.append('file', {
@@ -198,20 +217,16 @@ async function uploadAsset(fileUri, meta) {
         formData.append('hides_body_parts', JSON.stringify(meta.hides_body_parts));
     return studioFetchForm('/v1/assets', 'POST', formData);
 }
-exports.uploadAsset = uploadAsset;
 function deleteAsset(id) {
     return studioFetch(`/v1/assets/${id}`, { method: 'DELETE' });
 }
-exports.deleteAsset = deleteAsset;
 function suggestPlacement(assetId, avatarId) {
     return studioFetch(`/v1/assets/${assetId}/suggest-placement?avatar_id=${encodeURIComponent(avatarId)}`, { method: 'POST' });
 }
-exports.suggestPlacement = suggestPlacement;
 function assetFileUrl(asset) {
     const base = `${_baseUrl}${asset.url}`;
     return asset.updated_at ? `${base}?v=${encodeURIComponent(asset.updated_at)}` : base;
 }
-exports.assetFileUrl = assetFileUrl;
 async function createVoiceProfile(name, language = 'en') {
     return studioFetch('/profiles', {
         method: 'POST',
@@ -221,7 +236,6 @@ async function createVoiceProfile(name, language = 'en') {
         body: JSON.stringify({ name, language }),
     });
 }
-exports.createVoiceProfile = createVoiceProfile;
 async function uploadVoiceSample(profileId, fileUri, fileName, referenceText) {
     const formData = new FormData();
     formData.append('reference_text', referenceText);
@@ -233,4 +247,3 @@ async function uploadVoiceSample(profileId, fileUri, fileName, referenceText) {
     });
     return studioFetchForm(`/profiles/${profileId}/samples`, 'POST', formData);
 }
-exports.uploadVoiceSample = uploadVoiceSample;