talking-head-studio 0.4.10 → 0.4.12

package/dist/index.d.ts

@@ -1,5 +1,21 @@
-export type { TalkingHeadAccessory, TalkingHeadLoadingState, TalkingHeadLoadingStage, TalkingHeadMood, TalkingHeadProps, TalkingHeadRef, TalkingHeadViseme, TalkingHeadVisemeCue, TalkingHeadVisemeSchedule, } from './TalkingHead';
+export type { EngineVisemeMappingArtifact, OculusViseme, OculusVisemeWeights, RhubarbViseme, ArkitBlendShape, AgentVisemePayload, VisemeCue } from './core/avatar/visemes';
+export { ENGINE_VISEME_MAPPING, OCULUS_MORPH_TARGET_NAMES, OCULUS_VISEMES, RHUBARB_TO_OCULUS, RHUBARB_VISEMES, ARKIT_TO_OCULUS, oculusWeightsForRhubarbCue, remapArkitToOculus, getArkitWeightsForViseme } from './core/avatar/visemes';
+export type { FaceControl, ExpressionState, HeadPose, EyeGaze, Viseme } from './core/avatar/faceControls';
+export { createNeutralExpression, visemeToExpression, applyVisemeToExpression } from './core/avatar/faceControls';
+export type { AvatarBackend, CalibrationProfile, AvatarRenderTarget } from './core/avatar/backend';
+export { MorphTargetBackend } from './core/avatar/backends';
+export { GaussianBackend } from './core/avatar/backends';
+export type { GaussianBackendConfig } from './core/avatar/backends';
+export { walkAvatarSchema } from './core/avatar/schema';
+export type { AvatarSchemaReport, MorphCoverage, SkeletonInfo, MeshStats, VisemeTier, VísemeTier } from './core/avatar/schema';
+export { inspectAvatarCapabilities, inspectAvatarGltf, inspectAvatarJsonChunk, parseGlbJson } from './core/avatar/avatarCapabilities';
+export type { AvatarCapabilities, MotionCoverage } from './core/avatar/avatarCapabilities';
+export { MOTION_DEFS, MOTION_KEYS, isMotionKey, TALKINGHEAD_GESTURES, TALKINGHEAD_POSES, } from './core/avatar/motion';
+export type { MotionKey, MotionDef, MotionDefWithBones, MotionBoneKey, MotionOscillator, TalkingHeadGesture, TalkingHeadPose, } from './core/avatar/motion';
 export { TalkingHead } from './TalkingHead';
+export type { TalkingHeadRef, TalkingHeadProps, TalkingHeadMood, TalkingHeadAccessory, TalkingHeadLoadingState, TalkingHeadLoadingStage, TalkingHeadViseme, TalkingHeadVisemeCue, TalkingHeadVisemeSchedule, AvatarPlayerProps, AvatarPlayerRef, } from './TalkingHead';
+export { TalkingHeadVisualization } from './TalkingHeadVisualization';
+export type { TalkingHeadVisualizationRef } from './TalkingHeadVisualization';
 export { applyAppearanceToObject3D } from './appearance/apply';
 export { pickTargetForMaterialName } from './appearance/matchers';
 export { normalizeAppearance } from './appearance/schema';
@@ -9,3 +25,5 @@ export * from './wardrobe';
 export { useDirectVisemeStream } from './tts/useDirectVisemeStream';
 export type { VisemeStreamPayload } from './tts/useDirectVisemeStream';
 export { useMotionMarkers } from './tts/useMotionMarkers';
+export { useFaceControlsFromVisemes } from './voice/useFaceControls';
+export type { AvatarGlbParams, AvatarPlatformApi } from './platform/api/types';

package/dist/index.js

@@ -14,20 +14,59 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useMotionMarkers = exports.useDirectVisemeStream = exports.normalizeAppearance = exports.pickTargetForMaterialName = exports.applyAppearanceToObject3D = exports.TalkingHead = void 0;
+exports.useFaceControlsFromVisemes = exports.useMotionMarkers = exports.useDirectVisemeStream = exports.normalizeAppearance = exports.pickTargetForMaterialName = exports.applyAppearanceToObject3D = exports.TalkingHeadVisualization = exports.TalkingHead = exports.TALKINGHEAD_POSES = exports.TALKINGHEAD_GESTURES = exports.isMotionKey = exports.MOTION_KEYS = exports.MOTION_DEFS = exports.parseGlbJson = exports.inspectAvatarJsonChunk = exports.inspectAvatarGltf = exports.inspectAvatarCapabilities = exports.walkAvatarSchema = exports.GaussianBackend = exports.MorphTargetBackend = exports.applyVisemeToExpression = exports.visemeToExpression = exports.createNeutralExpression = exports.getArkitWeightsForViseme = exports.remapArkitToOculus = exports.oculusWeightsForRhubarbCue = exports.ARKIT_TO_OCULUS = exports.RHUBARB_VISEMES = exports.RHUBARB_TO_OCULUS = exports.OCULUS_VISEMES = exports.OCULUS_MORPH_TARGET_NAMES = exports.ENGINE_VISEME_MAPPING = void 0;
+var visemes_1 = require("./core/avatar/visemes");
+Object.defineProperty(exports, "ENGINE_VISEME_MAPPING", { enumerable: true, get: function () { return visemes_1.ENGINE_VISEME_MAPPING; } });
+Object.defineProperty(exports, "OCULUS_MORPH_TARGET_NAMES", { enumerable: true, get: function () { return visemes_1.OCULUS_MORPH_TARGET_NAMES; } });
+Object.defineProperty(exports, "OCULUS_VISEMES", { enumerable: true, get: function () { return visemes_1.OCULUS_VISEMES; } });
+Object.defineProperty(exports, "RHUBARB_TO_OCULUS", { enumerable: true, get: function () { return visemes_1.RHUBARB_TO_OCULUS; } });
+Object.defineProperty(exports, "RHUBARB_VISEMES", { enumerable: true, get: function () { return visemes_1.RHUBARB_VISEMES; } });
+Object.defineProperty(exports, "ARKIT_TO_OCULUS", { enumerable: true, get: function () { return visemes_1.ARKIT_TO_OCULUS; } });
+Object.defineProperty(exports, "oculusWeightsForRhubarbCue", { enumerable: true, get: function () { return visemes_1.oculusWeightsForRhubarbCue; } });
+Object.defineProperty(exports, "remapArkitToOculus", { enumerable: true, get: function () { return visemes_1.remapArkitToOculus; } });
+Object.defineProperty(exports, "getArkitWeightsForViseme", { enumerable: true, get: function () { return visemes_1.getArkitWeightsForViseme; } });
+var faceControls_1 = require("./core/avatar/faceControls");
+Object.defineProperty(exports, "createNeutralExpression", { enumerable: true, get: function () { return faceControls_1.createNeutralExpression; } });
+Object.defineProperty(exports, "visemeToExpression", { enumerable: true, get: function () { return faceControls_1.visemeToExpression; } });
+Object.defineProperty(exports, "applyVisemeToExpression", { enumerable: true, get: function () { return faceControls_1.applyVisemeToExpression; } });
+var backends_1 = require("./core/avatar/backends");
+Object.defineProperty(exports, "MorphTargetBackend", { enumerable: true, get: function () { return backends_1.MorphTargetBackend; } });
+var backends_2 = require("./core/avatar/backends");
+Object.defineProperty(exports, "GaussianBackend", { enumerable: true, get: function () { return backends_2.GaussianBackend; } });
+var schema_1 = require("./core/avatar/schema");
+Object.defineProperty(exports, "walkAvatarSchema", { enumerable: true, get: function () { return schema_1.walkAvatarSchema; } });
+var avatarCapabilities_1 = require("./core/avatar/avatarCapabilities");
+Object.defineProperty(exports, "inspectAvatarCapabilities", { enumerable: true, get: function () { return avatarCapabilities_1.inspectAvatarCapabilities; } });
+Object.defineProperty(exports, "inspectAvatarGltf", { enumerable: true, get: function () { return avatarCapabilities_1.inspectAvatarGltf; } });
+Object.defineProperty(exports, "inspectAvatarJsonChunk", { enumerable: true, get: function () { return avatarCapabilities_1.inspectAvatarJsonChunk; } });
+Object.defineProperty(exports, "parseGlbJson", { enumerable: true, get: function () { return avatarCapabilities_1.parseGlbJson; } });
+var motion_1 = require("./core/avatar/motion");
+Object.defineProperty(exports, "MOTION_DEFS", { enumerable: true, get: function () { return motion_1.MOTION_DEFS; } });
+Object.defineProperty(exports, "MOTION_KEYS", { enumerable: true, get: function () { return motion_1.MOTION_KEYS; } });
+Object.defineProperty(exports, "isMotionKey", { enumerable: true, get: function () { return motion_1.isMotionKey; } });
+Object.defineProperty(exports, "TALKINGHEAD_GESTURES", { enumerable: true, get: function () { return motion_1.TALKINGHEAD_GESTURES; } });
+Object.defineProperty(exports, "TALKINGHEAD_POSES", { enumerable: true, get: function () { return motion_1.TALKINGHEAD_POSES; } });
+// TalkingHead component + legacy type re-exports
 var TalkingHead_1 = require("./TalkingHead");
 Object.defineProperty(exports, "TalkingHead", { enumerable: true, get: function () { return TalkingHead_1.TalkingHead; } });
-// Export appearance utilities, but exclude AvatarAppearance — the canonical
-// AvatarAppearance (with equippedAccessories) comes from ./api below.
+var TalkingHeadVisualization_1 = require("./TalkingHeadVisualization");
+Object.defineProperty(exports, "TalkingHeadVisualization", { enumerable: true, get: function () { return TalkingHeadVisualization_1.TalkingHeadVisualization; } });
+// Appearance
 var apply_1 = require("./appearance/apply");
 Object.defineProperty(exports, "applyAppearanceToObject3D", { enumerable: true, get: function () { return apply_1.applyAppearanceToObject3D; } });
 var matchers_1 = require("./appearance/matchers");
 Object.defineProperty(exports, "pickTargetForMaterialName", { enumerable: true, get: function () { return matchers_1.pickTargetForMaterialName; } });
-var schema_1 = require("./appearance/schema");
-Object.defineProperty(exports, "normalizeAppearance", { enumerable: true, get: function () { return schema_1.normalizeAppearance; } });
+var schema_2 = require("./appearance/schema");
+Object.defineProperty(exports, "normalizeAppearance", { enumerable: true, get: function () { return schema_2.normalizeAppearance; } });
+// API
 __exportStar(require("./api"), exports);
+// Wardrobe
 __exportStar(require("./wardrobe"), exports);
+// TTS / Visemes
 var useDirectVisemeStream_1 = require("./tts/useDirectVisemeStream");
 Object.defineProperty(exports, "useDirectVisemeStream", { enumerable: true, get: function () { return useDirectVisemeStream_1.useDirectVisemeStream; } });
 var useMotionMarkers_1 = require("./tts/useMotionMarkers");
 Object.defineProperty(exports, "useMotionMarkers", { enumerable: true, get: function () { return useMotionMarkers_1.useMotionMarkers; } });
+// Face controls hook
+var useFaceControls_1 = require("./voice/useFaceControls");
+Object.defineProperty(exports, "useFaceControlsFromVisemes", { enumerable: true, get: function () { return useFaceControls_1.useFaceControlsFromVisemes; } });

package/dist/index.web.d.ts

@@ -1,5 +1,19 @@
-export type { TalkingHeadAccessory, TalkingHeadLoadingState, TalkingHeadMood, TalkingHeadProps, TalkingHeadRef, } from './TalkingHead.web';
+export type { AvatarPlayerProps, AvatarPlayerRef, TalkingHeadAccessory, TalkingHeadLoadingStage, TalkingHeadLoadingState, TalkingHeadMood, TalkingHeadProps, TalkingHeadRef, TalkingHeadViseme, TalkingHeadVisemeCue, TalkingHeadVisemeSchedule, } from './TalkingHead.web';
 export { TalkingHead } from './TalkingHead.web';
+export { buildAvatarHtml } from './html';
+export type { AvatarConfig } from './html';
+export type { EngineVisemeMappingArtifact, OculusViseme, OculusVisemeWeights, RhubarbViseme, ArkitBlendShape, AgentVisemePayload, VisemeCue } from './core/avatar/visemes';
+export { ENGINE_VISEME_MAPPING, OCULUS_MORPH_TARGET_NAMES, OCULUS_VISEMES, RHUBARB_TO_OCULUS, RHUBARB_VISEMES, ARKIT_TO_OCULUS, oculusWeightsForRhubarbCue, remapArkitToOculus, getArkitWeightsForViseme } from './core/avatar/visemes';
+export type { FaceControl, ExpressionState, HeadPose, EyeGaze, Viseme } from './core/avatar/faceControls';
+export { createNeutralExpression, visemeToExpression, applyVisemeToExpression } from './core/avatar/faceControls';
+export type { AvatarBackend, CalibrationProfile, AvatarRenderTarget } from './core/avatar/backend';
+export { MorphTargetBackend } from './core/avatar/backends';
+export { GaussianBackend } from './core/avatar/backends';
+export type { GaussianBackendConfig } from './core/avatar/backends';
+export { walkAvatarSchema } from './core/avatar/schema';
+export type { AvatarSchemaReport, MorphCoverage, SkeletonInfo, MeshStats, VisemeTier, VísemeTier } from './core/avatar/schema';
+export { MOTION_DEFS, MOTION_KEYS, isMotionKey, TALKINGHEAD_GESTURES, TALKINGHEAD_POSES, } from './core/avatar/motion';
+export type { MotionKey, MotionDef, MotionDefWithBones, MotionBoneKey, MotionOscillator, TalkingHeadGesture, TalkingHeadPose, } from './core/avatar/motion';
 export { applyAppearanceToObject3D } from './appearance/apply';
 export { pickTargetForMaterialName } from './appearance/matchers';
 export { normalizeAppearance } from './appearance/schema';
@@ -7,3 +21,6 @@ export type { AppearanceTarget } from './appearance/matchers';
 export * from './api';
 export { useDirectVisemeStream } from './tts/useDirectVisemeStream';
 export type { VisemeStreamPayload } from './tts/useDirectVisemeStream';
+export { useMotionMarkers } from './tts/useMotionMarkers';
+export { useFaceControlsFromVisemes } from './voice/useFaceControls';
+export type { AvatarGlbParams, AvatarPlatformApi } from './platform/api/types';

package/dist/index.web.js

@@ -14,17 +14,50 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useDirectVisemeStream = exports.normalizeAppearance = exports.pickTargetForMaterialName = exports.applyAppearanceToObject3D = exports.TalkingHead = void 0;
+exports.useFaceControlsFromVisemes = exports.useMotionMarkers = exports.useDirectVisemeStream = exports.normalizeAppearance = exports.pickTargetForMaterialName = exports.applyAppearanceToObject3D = exports.TALKINGHEAD_POSES = exports.TALKINGHEAD_GESTURES = exports.isMotionKey = exports.MOTION_KEYS = exports.MOTION_DEFS = exports.walkAvatarSchema = exports.GaussianBackend = exports.MorphTargetBackend = exports.applyVisemeToExpression = exports.visemeToExpression = exports.createNeutralExpression = exports.getArkitWeightsForViseme = exports.remapArkitToOculus = exports.oculusWeightsForRhubarbCue = exports.ARKIT_TO_OCULUS = exports.RHUBARB_VISEMES = exports.RHUBARB_TO_OCULUS = exports.OCULUS_VISEMES = exports.OCULUS_MORPH_TARGET_NAMES = exports.ENGINE_VISEME_MAPPING = exports.buildAvatarHtml = exports.TalkingHead = void 0;
 var TalkingHead_web_1 = require("./TalkingHead.web");
 Object.defineProperty(exports, "TalkingHead", { enumerable: true, get: function () { return TalkingHead_web_1.TalkingHead; } });
+var html_1 = require("./html");
+Object.defineProperty(exports, "buildAvatarHtml", { enumerable: true, get: function () { return html_1.buildAvatarHtml; } });
+var visemes_1 = require("./core/avatar/visemes");
+Object.defineProperty(exports, "ENGINE_VISEME_MAPPING", { enumerable: true, get: function () { return visemes_1.ENGINE_VISEME_MAPPING; } });
+Object.defineProperty(exports, "OCULUS_MORPH_TARGET_NAMES", { enumerable: true, get: function () { return visemes_1.OCULUS_MORPH_TARGET_NAMES; } });
+Object.defineProperty(exports, "OCULUS_VISEMES", { enumerable: true, get: function () { return visemes_1.OCULUS_VISEMES; } });
+Object.defineProperty(exports, "RHUBARB_TO_OCULUS", { enumerable: true, get: function () { return visemes_1.RHUBARB_TO_OCULUS; } });
+Object.defineProperty(exports, "RHUBARB_VISEMES", { enumerable: true, get: function () { return visemes_1.RHUBARB_VISEMES; } });
+Object.defineProperty(exports, "ARKIT_TO_OCULUS", { enumerable: true, get: function () { return visemes_1.ARKIT_TO_OCULUS; } });
+Object.defineProperty(exports, "oculusWeightsForRhubarbCue", { enumerable: true, get: function () { return visemes_1.oculusWeightsForRhubarbCue; } });
+Object.defineProperty(exports, "remapArkitToOculus", { enumerable: true, get: function () { return visemes_1.remapArkitToOculus; } });
+Object.defineProperty(exports, "getArkitWeightsForViseme", { enumerable: true, get: function () { return visemes_1.getArkitWeightsForViseme; } });
+var faceControls_1 = require("./core/avatar/faceControls");
+Object.defineProperty(exports, "createNeutralExpression", { enumerable: true, get: function () { return faceControls_1.createNeutralExpression; } });
+Object.defineProperty(exports, "visemeToExpression", { enumerable: true, get: function () { return faceControls_1.visemeToExpression; } });
+Object.defineProperty(exports, "applyVisemeToExpression", { enumerable: true, get: function () { return faceControls_1.applyVisemeToExpression; } });
+var backends_1 = require("./core/avatar/backends");
+Object.defineProperty(exports, "MorphTargetBackend", { enumerable: true, get: function () { return backends_1.MorphTargetBackend; } });
+var backends_2 = require("./core/avatar/backends");
+Object.defineProperty(exports, "GaussianBackend", { enumerable: true, get: function () { return backends_2.GaussianBackend; } });
+var schema_1 = require("./core/avatar/schema");
+Object.defineProperty(exports, "walkAvatarSchema", { enumerable: true, get: function () { return schema_1.walkAvatarSchema; } });
+var motion_1 = require("./core/avatar/motion");
+Object.defineProperty(exports, "MOTION_DEFS", { enumerable: true, get: function () { return motion_1.MOTION_DEFS; } });
+Object.defineProperty(exports, "MOTION_KEYS", { enumerable: true, get: function () { return motion_1.MOTION_KEYS; } });
+Object.defineProperty(exports, "isMotionKey", { enumerable: true, get: function () { return motion_1.isMotionKey; } });
+Object.defineProperty(exports, "TALKINGHEAD_GESTURES", { enumerable: true, get: function () { return motion_1.TALKINGHEAD_GESTURES; } });
+Object.defineProperty(exports, "TALKINGHEAD_POSES", { enumerable: true, get: function () { return motion_1.TALKINGHEAD_POSES; } });
 // Export appearance utilities, but exclude AvatarAppearance — the canonical
 // AvatarAppearance (with equippedAccessories) comes from ./api below.
 var apply_1 = require("./appearance/apply");
 Object.defineProperty(exports, "applyAppearanceToObject3D", { enumerable: true, get: function () { return apply_1.applyAppearanceToObject3D; } });
 var matchers_1 = require("./appearance/matchers");
 Object.defineProperty(exports, "pickTargetForMaterialName", { enumerable: true, get: function () { return matchers_1.pickTargetForMaterialName; } });
-var schema_1 = require("./appearance/schema");
-Object.defineProperty(exports, "normalizeAppearance", { enumerable: true, get: function () { return schema_1.normalizeAppearance; } });
+var schema_2 = require("./appearance/schema");
+Object.defineProperty(exports, "normalizeAppearance", { enumerable: true, get: function () { return schema_2.normalizeAppearance; } });
 __exportStar(require("./api"), exports);
 var useDirectVisemeStream_1 = require("./tts/useDirectVisemeStream");
 Object.defineProperty(exports, "useDirectVisemeStream", { enumerable: true, get: function () { return useDirectVisemeStream_1.useDirectVisemeStream; } });
+var useMotionMarkers_1 = require("./tts/useMotionMarkers");
+Object.defineProperty(exports, "useMotionMarkers", { enumerable: true, get: function () { return useMotionMarkers_1.useMotionMarkers; } });
+// Face controls hook
+var useFaceControls_1 = require("./voice/useFaceControls");
+Object.defineProperty(exports, "useFaceControlsFromVisemes", { enumerable: true, get: function () { return useFaceControls_1.useFaceControlsFromVisemes; } });

package/dist/platform/api/types.d.ts

@@ -0,0 +1,10 @@
+export interface AvatarGlbParams {
+    quality?: 'low' | 'medium' | 'high';
+    textureSize?: 256 | 512 | 1024 | 2048;
+    morphGroups?: ('oculus' | 'arkit' | 'expressions')[];
+    compression?: 'draco' | 'meshopt' | 'none';
+    textureFormat?: 'webp' | 'jpeg' | 'png';
+}
+export interface AvatarPlatformApi {
+    getAvatarUrl(id: string, params?: AvatarGlbParams): string;
+}

package/dist/platform/api/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/platform/marketplace/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Rarity tiers for catalog items — determines availability and pricing.
+ */
+export type RarityLevel = 'common' | 'uncommon' | 'rare' | 'legendary';
+/**
+ * A single item in the avatar catalog (clothing, hair, accessory, etc.).
+ */
+export interface CatalogItem {
+    id: string;
+    name: string;
+    /** Category tag, e.g. "hair", "outfit", "accessory", "body" */
+    category: string;
+    /** GLB asset URL */
+    glbUrl: string;
+    /** Preview image URL (2D thumbnail) */
+    thumbnailUrl?: string;
+    rarity: RarityLevel;
+    /** If set, item is only available to specific body types */
+    bodyTypeFilter?: string[];
+    /** Brand or collection tag */
+    collection?: string;
+    /** Price in platform credits; 0 = free */
+    price: number;
+}
+/**
+ * An avatar asset owned by a user (purchased or equipped).
+ */
+export interface AvatarAsset {
+    catalogItemId: string;
+    /** When the user acquired this item */
+    acquiredAt: string;
+}

package/dist/platform/marketplace/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/platform/sdk/unity.d.ts

@@ -0,0 +1,27 @@
+import type { AvatarGlbParams } from '../api/types';
+/**
+ * Configuration passed to the Unity SDK AvatarLoader.
+ * Maps to the C# AvatarSDKConfig struct in the Unity plugin.
+ */
+export interface UnitySdkConfig {
+    /** Base URL of the avatar platform API, e.g. "https://api.yourplatform.com" */
+    apiBaseUrl: string;
+    /** OAuth2 / API key for authenticated avatar downloads. */
+    apiKey?: string;
+    /** Default GLB quality params applied unless overridden per-avatar. */
+    defaultParams?: AvatarGlbParams;
+}
+/**
+ * Avatar metadata returned when a GLB is resolved for Unity.
+ * Mirrors the fields Unity's SkinnedMeshRenderer setup expects.
+ */
+export interface UnityAvatarManifest {
+    id: string;
+    glbUrl: string;
+    /** Morph target names present in the GLB, ordered as they appear. */
+    morphTargets: string[];
+    /** Whether Oculus viseme morph targets are present. */
+    hasOculusVisemes: boolean;
+    /** Whether ARKit blendshape morph targets are present. */
+    hasArkit: boolean;
+}

package/dist/platform/sdk/unity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/platform/sdk/unreal.d.ts

@@ -0,0 +1,23 @@
+import type { AvatarGlbParams } from '../api/types';
+/**
+ * Configuration for the Unreal Engine plugin.
+ * Maps to the UE5 UAvatarSDKSettings data asset.
+ */
+export interface UnrealSdkConfig {
+    /** Base URL of the avatar platform API. */
+    apiBaseUrl: string;
+    /** API key for authenticated requests. */
+    apiKey?: string;
+    /** Default GLB quality params. */
+    defaultParams?: AvatarGlbParams;
+}
+/**
+ * Blueprint-friendly avatar descriptor.
+ * Exposed as a UStruct in the Unreal plugin.
+ */
+export interface UnrealAvatarDescriptor {
+    id: string;
+    glbUrl: string;
+    /** Morph target names for Blueprint binding. */
+    morphTargets: string[];
+}

package/dist/platform/sdk/unreal.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/platform/sdk/web.d.ts

@@ -0,0 +1,16 @@
+import type { AvatarGlbParams } from '../api/types';
+import type { AgentVisemePayload } from '../../core/avatar/visemes';
+/**
+ * Minimal contract for the web SDK — fetch a GLB and drive morph targets.
+ * Implemented by any engine integration (Three.js, Babylon.js, etc.)
+ */
+export interface AvatarWebSDK {
+    /** Build the GLB download URL for a given avatar id and quality params. */
+    getAvatarUrl(id: string, params?: AvatarGlbParams): string;
+    /** Schedule viseme morph-target animation from a TTS payload. */
+    scheduleVisemes(payload: AgentVisemePayload): void;
+    /** Drive jaw open/close from raw audio amplitude (0–1). */
+    sendAmplitude(amplitude: number): void;
+    /** Release GPU/memory resources. */
+    dispose(): void;
+}

package/dist/platform/sdk/web.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sketchfab/api.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBestThumbnail = exports.downloadModel = exports.getDownloadUrl = exports.searchSketchfab = void 0;
+exports.searchSketchfab = searchSketchfab;
+exports.getDownloadUrl = getDownloadUrl;
+exports.downloadModel = downloadModel;
+exports.getBestThumbnail = getBestThumbnail;
 const SKETCHFAB_API_BASE = 'https://api.sketchfab.com/v3';
 const PAGE_SIZE = 24;
 async function searchSketchfab(options) {
@@ -8,6 +11,7 @@ async function searchSketchfab(options) {
     const params = new URLSearchParams({
         type: 'models',
         downloadable: 'true',
+        rigged: 'true',
         count: String(count),
         sort_by: '-likeCount',
         q: query,
@@ -23,7 +27,6 @@ async function searchSketchfab(options) {
     }
     return response.json();
 }
-exports.searchSketchfab = searchSketchfab;
 async function getDownloadUrl(uid, apiKey) {
     const response = await fetch(`${SKETCHFAB_API_BASE}/models/${uid}/download`, {
         headers: { Authorization: `Token ${apiKey}` },
@@ -34,7 +37,6 @@ async function getDownloadUrl(uid, apiKey) {
     const data = (await response.json());
     return data?.glb?.url ?? data?.gltf?.url ?? null;
 }
-exports.getDownloadUrl = getDownloadUrl;
 async function downloadModel(uid, name, apiKey) {
     const url = await getDownloadUrl(uid, apiKey);
     if (!url) {
@@ -48,7 +50,6 @@ async function downloadModel(uid, name, apiKey) {
     const cleanName = name.replace(/[^\w\s-]/g, '').trim() || 'model';
     return new File([blob], `${cleanName}.glb`, { type: 'model/gltf-binary' });
 }
-exports.downloadModel = downloadModel;
 function getBestThumbnail(thumbnails, targetWidth = 280) {
     if (!thumbnails?.images?.length) {
         return '';
@@ -56,4 +57,3 @@ function getBestThumbnail(thumbnails, targetWidth = 280) {
     const sorted = [...thumbnails.images].sort((left, right) => Math.abs(left.width - targetWidth) - Math.abs(right.width - targetWidth));
     return sorted[0].url;
 }
-exports.getBestThumbnail = getBestThumbnail;

package/dist/sketchfab/glbInspect.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Lightweight GLB inspection — reads the JSON chunk header only, no geometry.
+ *
+ * Used to detect whether a downloaded model has morph targets (blend shapes)
+ * before importing it. Models without morph targets can't do real lipsync;
+ * we fall back to jaw-bone animation, which is much worse.
+ */
+/** Byte length of the GLB JSON chunk, or null if not a valid GLB header. */
+export declare function glbJsonChunkLength(header: Uint8Array): number | null;
+export interface GlbMorphInfo {
+    /** Total morph targets across all mesh primitives. */
+    morphTargetCount: number;
+    /** Names from mesh.extras.targetNames where present (lowercased). */
+    targetNames: string[];
+}
+/**
+ * Inspect a glTF JSON document (the parsed JSON chunk of a GLB) for morph
+ * targets. Returns counts and any declared target names.
+ */
+export declare function inspectGltfMorphs(gltf: unknown): GlbMorphInfo;
+/** Parse the JSON chunk bytes of a GLB and inspect morph targets. */
+export declare function inspectGlbJsonChunk(jsonBytes: Uint8Array): GlbMorphInfo;

package/dist/sketchfab/glbInspect.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Lightweight GLB inspection — reads the JSON chunk header only, no geometry.
+ *
+ * Used to detect whether a downloaded model has morph targets (blend shapes)
+ * before importing it. Models without morph targets can't do real lipsync;
+ * we fall back to jaw-bone animation, which is much worse.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.glbJsonChunkLength = glbJsonChunkLength;
+exports.inspectGltfMorphs = inspectGltfMorphs;
+exports.inspectGlbJsonChunk = inspectGlbJsonChunk;
+const GLB_MAGIC = 0x46546c67; // 'glTF'
+const CHUNK_JSON = 0x4e4f534a; // 'JSON'
+/** Byte length of the GLB JSON chunk, or null if not a valid GLB header. */
+function glbJsonChunkLength(header) {
+    if (header.length < 20)
+        return null;
+    const view = new DataView(header.buffer, header.byteOffset, header.byteLength);
+    if (view.getUint32(0, true) !== GLB_MAGIC)
+        return null;
+    if (view.getUint32(16, true) !== CHUNK_JSON)
+        return null;
+    return view.getUint32(12, true);
+}
+/**
+ * Inspect a glTF JSON document (the parsed JSON chunk of a GLB) for morph
+ * targets. Returns counts and any declared target names.
+ */
+function inspectGltfMorphs(gltf) {
+    const info = { morphTargetCount: 0, targetNames: [] };
+    const meshes = gltf?.meshes;
+    if (!Array.isArray(meshes))
+        return info;
+    for (const mesh of meshes) {
+        const primitives = mesh?.primitives;
+        if (Array.isArray(primitives)) {
+            for (const prim of primitives) {
+                const targets = prim?.targets;
+                if (Array.isArray(targets))
+                    info.morphTargetCount += targets.length;
+            }
+        }
+        const names = mesh?.extras?.targetNames;
+        if (Array.isArray(names)) {
+            for (const n of names) {
+                if (typeof n === 'string')
+                    info.targetNames.push(n.toLowerCase());
+            }
+        }
+    }
+    return info;
+}
+/** Parse the JSON chunk bytes of a GLB and inspect morph targets. */
+function inspectGlbJsonChunk(jsonBytes) {
+    const text = new TextDecoder().decode(jsonBytes);
+    return inspectGltfMorphs(JSON.parse(text));
+}

package/dist/sketchfab/index.d.ts

@@ -2,5 +2,8 @@ export { searchSketchfab, getDownloadUrl, downloadModel, getBestThumbnail } from
 export type { SketchfabSearchOptions } from './api';
 export { useSketchfabSearch } from './useSketchfabSearch';
 export type { UseSketchfabSearchOptions, UseSketchfabSearchResult } from './useSketchfabSearch';
+export { glbJsonChunkLength, inspectGlbJsonChunk, inspectGltfMorphs } from './glbInspect';
+export type { GlbMorphInfo } from './glbInspect';
+export { inspectAvatarFromUrl, fetchSketchfabCapabilities } from './inspectRemote';
 export { ACCESSORY_CATEGORIES, HUMANOID_TAGS } from './categories';
 export type { SketchfabModel, SketchfabResponse, AccessoryCategory } from './types';

package/dist/sketchfab/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HUMANOID_TAGS = exports.ACCESSORY_CATEGORIES = exports.useSketchfabSearch = exports.getBestThumbnail = exports.downloadModel = exports.getDownloadUrl = exports.searchSketchfab = void 0;
+exports.HUMANOID_TAGS = exports.ACCESSORY_CATEGORIES = exports.fetchSketchfabCapabilities = exports.inspectAvatarFromUrl = exports.inspectGltfMorphs = exports.inspectGlbJsonChunk = exports.glbJsonChunkLength = exports.useSketchfabSearch = exports.getBestThumbnail = exports.downloadModel = exports.getDownloadUrl = exports.searchSketchfab = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "searchSketchfab", { enumerable: true, get: function () { return api_1.searchSketchfab; } });
 Object.defineProperty(exports, "getDownloadUrl", { enumerable: true, get: function () { return api_1.getDownloadUrl; } });
@@ -8,6 +8,13 @@ Object.defineProperty(exports, "downloadModel", { enumerable: true, get: functio
 Object.defineProperty(exports, "getBestThumbnail", { enumerable: true, get: function () { return api_1.getBestThumbnail; } });
 var useSketchfabSearch_1 = require("./useSketchfabSearch");
 Object.defineProperty(exports, "useSketchfabSearch", { enumerable: true, get: function () { return useSketchfabSearch_1.useSketchfabSearch; } });
+var glbInspect_1 = require("./glbInspect");
+Object.defineProperty(exports, "glbJsonChunkLength", { enumerable: true, get: function () { return glbInspect_1.glbJsonChunkLength; } });
+Object.defineProperty(exports, "inspectGlbJsonChunk", { enumerable: true, get: function () { return glbInspect_1.inspectGlbJsonChunk; } });
+Object.defineProperty(exports, "inspectGltfMorphs", { enumerable: true, get: function () { return glbInspect_1.inspectGltfMorphs; } });
+var inspectRemote_1 = require("./inspectRemote");
+Object.defineProperty(exports, "inspectAvatarFromUrl", { enumerable: true, get: function () { return inspectRemote_1.inspectAvatarFromUrl; } });
+Object.defineProperty(exports, "fetchSketchfabCapabilities", { enumerable: true, get: function () { return inspectRemote_1.fetchSketchfabCapabilities; } });
 var categories_1 = require("./categories");
 Object.defineProperty(exports, "ACCESSORY_CATEGORIES", { enumerable: true, get: function () { return categories_1.ACCESSORY_CATEGORIES; } });
 Object.defineProperty(exports, "HUMANOID_TAGS", { enumerable: true, get: function () { return categories_1.HUMANOID_TAGS; } });

package/dist/sketchfab/inspectRemote.d.ts

@@ -0,0 +1,13 @@
+import { type AvatarCapabilities } from '../core/avatar/avatarCapabilities';
+/**
+ * Capability report for a GLB at `glbUrl`, read via two small Range requests
+ * (header, then JSON chunk). Returns null when the model can't be cheaply
+ * inspected (no Range support, bad header, oversized/short JSON chunk, network
+ * error or abort) — callers treat null as "unknown", never as "bad".
+ */
+export declare function inspectAvatarFromUrl(glbUrl: string, signal?: AbortSignal): Promise<AvatarCapabilities | null>;
+/**
+ * Resolve a Sketchfab model's signed GLB URL and inspect its capabilities
+ * without a full download. Returns null on any failure ("unknown").
+ */
+export declare function fetchSketchfabCapabilities(uid: string, apiKey: string, signal?: AbortSignal): Promise<AvatarCapabilities | null>;

package/dist/sketchfab/inspectRemote.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectAvatarFromUrl = inspectAvatarFromUrl;
+exports.fetchSketchfabCapabilities = fetchSketchfabCapabilities;
+/**
+ * Remote (pre-download) avatar capability inspection for Sketchfab results.
+ *
+ * Reads only the GLB header + JSON chunk via HTTP Range requests so we can tell
+ * whether a search result can lip-sync + move BEFORE the user commits to a full
+ * download/import. This is what lets the picker float "good-first" avatars to
+ * the top and badge them.
+ *
+ * Safety: a host that ignores Range and replies 200 would stream the whole file
+ * (models go up to 50MB), so we bail unless the response is a 206 Partial
+ * Content. The JSON chunk holds only metadata (nodes/meshes/skins/accessors),
+ * not geometry, so it stays small even for dense rigs.
+ */
+const glbInspect_1 = require("./glbInspect");
+const api_1 = require("./api");
+const avatarCapabilities_1 = require("../core/avatar/avatarCapabilities");
+/** Sanity cap on the JSON chunk we'll pull before giving up (treated as
+ *  "unknown"). Real avatar JSON chunks are well under this. */
+const MAX_JSON_CHUNK_BYTES = 8 * 1024 * 1024;
+async function rangeBytes(url, start, endInclusive, signal) {
+    const res = await fetch(url, {
+        headers: { Range: `bytes=${start}-${endInclusive}` },
+        signal,
+    });
+    // Require a partial response. A 200 means the host ignored Range and is about
+    // to hand us the entire file — abandon the body so we never pull 50MB.
+    if (res.status !== 206) {
+        const body = res.body;
+        if (body?.cancel) {
+            try {
+                await body.cancel();
+            }
+            catch {
+                /* best effort */
+            }
+        }
+        return null;
+    }
+    return new Uint8Array(await res.arrayBuffer());
+}
+/**
+ * Capability report for a GLB at `glbUrl`, read via two small Range requests
+ * (header, then JSON chunk). Returns null when the model can't be cheaply
+ * inspected (no Range support, bad header, oversized/short JSON chunk, network
+ * error or abort) — callers treat null as "unknown", never as "bad".
+ */
+async function inspectAvatarFromUrl(glbUrl, signal) {
+    try {
+        const header = await rangeBytes(glbUrl, 0, 19, signal);
+        if (!header)
+            return null;
+        const jsonLen = (0, glbInspect_1.glbJsonChunkLength)(header);
+        if (jsonLen === null || jsonLen <= 0 || jsonLen > MAX_JSON_CHUNK_BYTES)
+            return null;
+        const jsonBytes = await rangeBytes(glbUrl, 20, 20 + jsonLen - 1, signal);
+        if (!jsonBytes || jsonBytes.length < jsonLen)
+            return null;
+        return (0, avatarCapabilities_1.inspectAvatarJsonChunk)(jsonBytes);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve a Sketchfab model's signed GLB URL and inspect its capabilities
+ * without a full download. Returns null on any failure ("unknown").
+ */
+async function fetchSketchfabCapabilities(uid, apiKey, signal) {
+    const url = await (0, api_1.getDownloadUrl)(uid, apiKey);
+    if (!url)
+        return null;
+    return inspectAvatarFromUrl(url, signal);
+}

package/dist/sketchfab/types.d.ts

@@ -29,6 +29,16 @@ export interface SketchfabModel {
         label: string;
     } | null;
     isDownloadable: boolean;
+    archives?: {
+        glb?: {
+            size: number;
+            url?: string;
+        };
+        gltf?: {
+            size: number;
+            url?: string;
+        };
+    };
 }
 export interface SketchfabResponse {
     results: SketchfabModel[];

package/dist/sketchfab/useSketchfabSearch.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useSketchfabSearch = void 0;
+exports.useSketchfabSearch = useSketchfabSearch;
 const react_1 = require("react");
 const api_1 = require("./api");
 function useSketchfabSearch({ apiKey, initialQuery = 'character humanoid avatar', debounceMs = 400, }) {
@@ -79,4 +79,3 @@ function useSketchfabSearch({ apiKey, initialQuery = 'character humanoid avatar'
         prevPage,
     };
 }
-exports.useSketchfabSearch = useSketchfabSearch;

package/dist/studio/AccessoryBrowserScreen.d.ts

@@ -0,0 +1,6 @@
+export interface AccessoryBrowserScreenProps {
+    avatarId?: string;
+    sketchfabApiKey: string;
+    onDone?: () => void;
+}
+export declare function AccessoryBrowserScreen({ avatarId, sketchfabApiKey, onDone, }: AccessoryBrowserScreenProps): import("react/jsx-runtime").JSX.Element;