talking-head-studio 0.4.11 → 0.4.12

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { OculusViseme, ArkitBlendShape, AgentVisemePayload, VisemeCue } from './core/avatar/visemes';
-export { OCULUS_VISEMES, ARKIT_TO_OCULUS, remapArkitToOculus, getArkitWeightsForViseme } from './core/avatar/visemes';
+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';
@@ -7,7 +7,11 @@ 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, VísemeTier } 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';

package/dist/index.js

@@ -14,10 +14,15 @@ 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.useFaceControlsFromVisemes = exports.useMotionMarkers = exports.useDirectVisemeStream = exports.normalizeAppearance = exports.pickTargetForMaterialName = exports.applyAppearanceToObject3D = exports.TalkingHeadVisualization = exports.TalkingHead = exports.walkAvatarSchema = exports.GaussianBackend = exports.MorphTargetBackend = exports.applyVisemeToExpression = exports.visemeToExpression = exports.createNeutralExpression = exports.getArkitWeightsForViseme = exports.remapArkitToOculus = exports.ARKIT_TO_OCULUS = exports.OCULUS_VISEMES = 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");
@@ -30,6 +35,17 @@ 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; } });

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/sketchfab/api.js

@@ -11,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,

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/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;