@vizij/render 0.1.0 → 0.1.1

package/dist/index.d.mts

@@ -357,12 +357,40 @@ interface VizijBundleAnimationEntry {
         [key: string]: unknown;
     };
 }
+interface VizijSpeechConfig {
+    /** TTS voice name (e.g., "Ruth") */
+    voice?: string;
+    /** Speech mode */
+    mode?: "echo" | "conversation";
+    /** Agent name for LLM system prompt */
+    agentName?: string;
+    /** Custom system prompt (supports {{agent_name}} template) */
+    systemPrompt?: string;
+    /** Input path for avatar-speaking state (default: /speech/speaking) */
+    speakingInputPath?: string;
+    /** Input path for user-speaking state (default: /speech/user_speaking) */
+    userSpeakingInputPath?: string;
+    /** Input path for thinking state (default: /speech/thinking) */
+    thinkingInputPath?: string;
+    /** Pose group ID for viseme mapping */
+    visemeGroupId?: string;
+    /** Pose group ID for emotion mapping */
+    emotionGroupId?: string;
+    /** TTS API base URL */
+    apiBaseUrl?: string;
+    /** Auto-activate microphone when speech is ready (default: false) */
+    autoActivateMic?: boolean;
+}
 interface VizijBundleExtension {
     version: VizijBundleVersion;
     exportedAt?: string;
     graphs?: VizijBundleGraphEntry[];
     poses?: VizijBundlePoseSection | null;
     animations?: VizijBundleAnimationEntry[];
+    /**
+     * Bundle-level metadata. May include `speechConfig: VizijSpeechConfig`
+     * for configuring the STT/LLM/TTS speech pipeline.
+     */
     metadata?: Record<string, unknown>;
 }
 
@@ -571,6 +599,12 @@ declare function useVizijStoreGetter(): () => VizijData & VizijActions;
 declare class EmptyModelError extends Error {
     constructor(message: string);
 }
+type ParserJsonFallbackSource = {
+    url?: string;
+    blob?: Blob;
+    arrayBuffer?: ArrayBuffer;
+};
+declare function parseGlbJsonChunk(buffer: ArrayBuffer): unknown | undefined;
 declare function loadGLTF(url: string, namespaces: string[], aggressiveImport?: boolean, rootBounds?: {
     center: RawVector2;
     size: RawVector2;
@@ -584,11 +618,12 @@ type LoadedVizijAsset = {
     animatables: Record<string, AnimatableValue>;
     bundle: VizijBundleExtension | null;
     animations: VizijAnimationClipData[];
+    scene: Group$1;
 };
 declare function loadGLTFWithBundle(url: string, namespaces: string[], aggressiveImport?: boolean, rootBounds?: {
     center: RawVector2;
     size: RawVector2;
-}): Promise<LoadedVizijAsset>;
+}, parserJsonFallback?: ParserJsonFallbackSource): Promise<LoadedVizijAsset>;
 declare function loadGLTFFromBlobWithBundle(blob: Blob, namespaces: string[], aggressiveImport?: boolean, rootBounds?: {
     center: RawVector2;
     size: RawVector2;
@@ -607,10 +642,12 @@ type ExportSceneOptions = {
     bundle?: VizijBundleExtension | null;
     animations?: AnimationClip[];
     binary?: boolean;
+    onError?: (error: Error) => void;
+    onComplete?: () => void;
 };
 declare function exportScene(data: Group$1, fileNameOrOptions?: string | ExportSceneOptions): void;
 
 declare function extractVizijBundle(object: Object3D, parserJson?: unknown): VizijBundleExtension | null;
 declare function applyVizijBundle(object: Object3D, bundle: VizijBundleExtension | null): () => void;
 
-export { type AnimatedFeature, type Ellipse, type EllipseFeature, EmptyModelError, type ExportSceneOptions, type Feature, type Group, type GroupFeature, InnerVizij, type InnerVizijProps, type LoadedVizijAsset, type Rectangle, type RectangleFeature, type RenderableBase, type RenderableFeature, type Selection, type Shape, type ShapeFeature, ShapeMaterial, type StaticFeature, type Stored, type StoredAnimatedFeature, type StoredEllipse, type StoredFeatures, type StoredGroup, type StoredRectangle, type StoredRenderable, type StoredShape, Vizij, type VizijActions, type VizijAnimationClipData, type VizijAnimationId, type VizijAnimationTrackData, type VizijBundleAnimationClip, type VizijBundleAnimationEntry, type VizijBundleAnimationKeyframe, type VizijBundleAnimationTrack, type VizijBundleExtension, type VizijBundleGraphEntry, type VizijBundleGraphKind, type VizijBundleGraphMetadata, type VizijBundlePoseSection, type VizijBundleVersion, VizijContext, type VizijData, type VizijGraphId, type VizijPoseDefinition, type VizijPoseId, type VizijPoseRigConfig, type VizijProps, VizijSlice, type VizijStore, type VizijStoreGetter, type VizijStoreSetter, type World, applyVizijBundle, createVizijStore, exportScene, extractVizijBundle, loadGLTF, loadGLTFFromBlob, loadGLTFFromBlobWithBundle, loadGLTFWithBundle, loadGltfFromBlob, useDefaultVizijStore, useFeatures, useVizijStore, useVizijStoreGetter, useVizijStoreSetter, useVizijStoreSubscription };
+export { type AnimatedFeature, type Ellipse, type EllipseFeature, EmptyModelError, type ExportSceneOptions, type Feature, type Group, type GroupFeature, InnerVizij, type InnerVizijProps, type LoadedVizijAsset, type Rectangle, type RectangleFeature, type RenderableBase, type RenderableFeature, type Selection, type Shape, type ShapeFeature, ShapeMaterial, type StaticFeature, type Stored, type StoredAnimatedFeature, type StoredEllipse, type StoredFeatures, type StoredGroup, type StoredRectangle, type StoredRenderable, type StoredShape, Vizij, type VizijActions, type VizijAnimationClipData, type VizijAnimationId, type VizijAnimationTrackData, type VizijBundleAnimationClip, type VizijBundleAnimationEntry, type VizijBundleAnimationKeyframe, type VizijBundleAnimationTrack, type VizijBundleExtension, type VizijBundleGraphEntry, type VizijBundleGraphKind, type VizijBundleGraphMetadata, type VizijBundlePoseSection, type VizijBundleVersion, VizijContext, type VizijData, type VizijGraphId, type VizijPoseDefinition, type VizijPoseId, type VizijPoseRigConfig, type VizijProps, VizijSlice, type VizijSpeechConfig, type VizijStore, type VizijStoreGetter, type VizijStoreSetter, type World, applyVizijBundle, createVizijStore, exportScene, extractVizijBundle, loadGLTF, loadGLTFFromBlob, loadGLTFFromBlobWithBundle, loadGLTFWithBundle, loadGltfFromBlob, parseGlbJsonChunk, useDefaultVizijStore, useFeatures, useVizijStore, useVizijStoreGetter, useVizijStoreSetter, useVizijStoreSubscription };

package/dist/index.d.ts

@@ -357,12 +357,40 @@ interface VizijBundleAnimationEntry {
         [key: string]: unknown;
     };
 }
+interface VizijSpeechConfig {
+    /** TTS voice name (e.g., "Ruth") */
+    voice?: string;
+    /** Speech mode */
+    mode?: "echo" | "conversation";
+    /** Agent name for LLM system prompt */
+    agentName?: string;
+    /** Custom system prompt (supports {{agent_name}} template) */
+    systemPrompt?: string;
+    /** Input path for avatar-speaking state (default: /speech/speaking) */
+    speakingInputPath?: string;
+    /** Input path for user-speaking state (default: /speech/user_speaking) */
+    userSpeakingInputPath?: string;
+    /** Input path for thinking state (default: /speech/thinking) */
+    thinkingInputPath?: string;
+    /** Pose group ID for viseme mapping */
+    visemeGroupId?: string;
+    /** Pose group ID for emotion mapping */
+    emotionGroupId?: string;
+    /** TTS API base URL */
+    apiBaseUrl?: string;
+    /** Auto-activate microphone when speech is ready (default: false) */
+    autoActivateMic?: boolean;
+}
 interface VizijBundleExtension {
     version: VizijBundleVersion;
     exportedAt?: string;
     graphs?: VizijBundleGraphEntry[];
     poses?: VizijBundlePoseSection | null;
     animations?: VizijBundleAnimationEntry[];
+    /**
+     * Bundle-level metadata. May include `speechConfig: VizijSpeechConfig`
+     * for configuring the STT/LLM/TTS speech pipeline.
+     */
     metadata?: Record<string, unknown>;
 }
 
@@ -571,6 +599,12 @@ declare function useVizijStoreGetter(): () => VizijData & VizijActions;
 declare class EmptyModelError extends Error {
     constructor(message: string);
 }
+type ParserJsonFallbackSource = {
+    url?: string;
+    blob?: Blob;
+    arrayBuffer?: ArrayBuffer;
+};
+declare function parseGlbJsonChunk(buffer: ArrayBuffer): unknown | undefined;
 declare function loadGLTF(url: string, namespaces: string[], aggressiveImport?: boolean, rootBounds?: {
     center: RawVector2;
     size: RawVector2;
@@ -584,11 +618,12 @@ type LoadedVizijAsset = {
     animatables: Record<string, AnimatableValue>;
     bundle: VizijBundleExtension | null;
     animations: VizijAnimationClipData[];
+    scene: Group$1;
 };
 declare function loadGLTFWithBundle(url: string, namespaces: string[], aggressiveImport?: boolean, rootBounds?: {
     center: RawVector2;
     size: RawVector2;
-}): Promise<LoadedVizijAsset>;
+}, parserJsonFallback?: ParserJsonFallbackSource): Promise<LoadedVizijAsset>;
 declare function loadGLTFFromBlobWithBundle(blob: Blob, namespaces: string[], aggressiveImport?: boolean, rootBounds?: {
     center: RawVector2;
     size: RawVector2;
@@ -607,10 +642,12 @@ type ExportSceneOptions = {
     bundle?: VizijBundleExtension | null;
     animations?: AnimationClip[];
     binary?: boolean;
+    onError?: (error: Error) => void;
+    onComplete?: () => void;
 };
 declare function exportScene(data: Group$1, fileNameOrOptions?: string | ExportSceneOptions): void;
 
 declare function extractVizijBundle(object: Object3D, parserJson?: unknown): VizijBundleExtension | null;
 declare function applyVizijBundle(object: Object3D, bundle: VizijBundleExtension | null): () => void;
 
-export { type AnimatedFeature, type Ellipse, type EllipseFeature, EmptyModelError, type ExportSceneOptions, type Feature, type Group, type GroupFeature, InnerVizij, type InnerVizijProps, type LoadedVizijAsset, type Rectangle, type RectangleFeature, type RenderableBase, type RenderableFeature, type Selection, type Shape, type ShapeFeature, ShapeMaterial, type StaticFeature, type Stored, type StoredAnimatedFeature, type StoredEllipse, type StoredFeatures, type StoredGroup, type StoredRectangle, type StoredRenderable, type StoredShape, Vizij, type VizijActions, type VizijAnimationClipData, type VizijAnimationId, type VizijAnimationTrackData, type VizijBundleAnimationClip, type VizijBundleAnimationEntry, type VizijBundleAnimationKeyframe, type VizijBundleAnimationTrack, type VizijBundleExtension, type VizijBundleGraphEntry, type VizijBundleGraphKind, type VizijBundleGraphMetadata, type VizijBundlePoseSection, type VizijBundleVersion, VizijContext, type VizijData, type VizijGraphId, type VizijPoseDefinition, type VizijPoseId, type VizijPoseRigConfig, type VizijProps, VizijSlice, type VizijStore, type VizijStoreGetter, type VizijStoreSetter, type World, applyVizijBundle, createVizijStore, exportScene, extractVizijBundle, loadGLTF, loadGLTFFromBlob, loadGLTFFromBlobWithBundle, loadGLTFWithBundle, loadGltfFromBlob, useDefaultVizijStore, useFeatures, useVizijStore, useVizijStoreGetter, useVizijStoreSetter, useVizijStoreSubscription };
+export { type AnimatedFeature, type Ellipse, type EllipseFeature, EmptyModelError, type ExportSceneOptions, type Feature, type Group, type GroupFeature, InnerVizij, type InnerVizijProps, type LoadedVizijAsset, type Rectangle, type RectangleFeature, type RenderableBase, type RenderableFeature, type Selection, type Shape, type ShapeFeature, ShapeMaterial, type StaticFeature, type Stored, type StoredAnimatedFeature, type StoredEllipse, type StoredFeatures, type StoredGroup, type StoredRectangle, type StoredRenderable, type StoredShape, Vizij, type VizijActions, type VizijAnimationClipData, type VizijAnimationId, type VizijAnimationTrackData, type VizijBundleAnimationClip, type VizijBundleAnimationEntry, type VizijBundleAnimationKeyframe, type VizijBundleAnimationTrack, type VizijBundleExtension, type VizijBundleGraphEntry, type VizijBundleGraphKind, type VizijBundleGraphMetadata, type VizijBundlePoseSection, type VizijBundleVersion, VizijContext, type VizijData, type VizijGraphId, type VizijPoseDefinition, type VizijPoseId, type VizijPoseRigConfig, type VizijProps, VizijSlice, type VizijSpeechConfig, type VizijStore, type VizijStoreGetter, type VizijStoreSetter, type World, applyVizijBundle, createVizijStore, exportScene, extractVizijBundle, loadGLTF, loadGLTFFromBlob, loadGLTFFromBlobWithBundle, loadGLTFWithBundle, loadGltfFromBlob, parseGlbJsonChunk, useDefaultVizijStore, useFeatures, useVizijStore, useVizijStoreGetter, useVizijStoreSetter, useVizijStoreSubscription };

package/dist/index.js

@@ -45,6 +45,7 @@ __export(index_exports, {
   loadGLTFFromBlobWithBundle: () => loadGLTFFromBlobWithBundle,
   loadGLTFWithBundle: () => loadGLTFWithBundle,
   loadGltfFromBlob: () => loadGltfFromBlob,
+  parseGlbJsonChunk: () => parseGlbJsonChunk,
   useDefaultVizijStore: () => useDefaultVizijStore,
   useFeatures: () => useFeatures,
   useVizijStore: () => useVizijStore,
@@ -1434,6 +1435,35 @@ function createAnimatable(value) {
 }
 createAnimatable({ type: "euler", name: "Rotation" });
 
+// src/functions/exportable-bodies.ts
+function asGroupEntries(world) {
+  return Object.values(world).filter((entry) => entry.type === "group");
+}
+function selectExportableGroupEntries(world, filterIds) {
+  const groupEntries = asGroupEntries(world);
+  const filterSet = Array.isArray(filterIds) && filterIds.length > 0 ? new Set(filterIds) : null;
+  if (filterSet) {
+    return groupEntries.filter((entry) => filterSet.has(entry.id));
+  }
+  const rootBoundsGroups = groupEntries.filter(
+    (entry) => Boolean(entry.rootBounds)
+  );
+  if (rootBoundsGroups.length > 0) {
+    return rootBoundsGroups;
+  }
+  const explicitRootGroups = groupEntries.filter(
+    (entry) => entry.root === true
+  );
+  if (explicitRootGroups.length > 0) {
+    return explicitRootGroups;
+  }
+  const topLevelGroups = groupEntries.filter((entry) => !entry.parent);
+  if (topLevelGroups.length > 0) {
+    return topLevelGroups;
+  }
+  return groupEntries;
+}
+
 // src/store.ts
 THREE3.Object3D.DEFAULT_UP.set(0, 0, 1);
 (0, import_immer.enableMapSet)();
@@ -1509,23 +1539,17 @@ var VizijSlice = (set, get) => ({
   },
   getExportableBodies: (filterIds) => {
     const worldData = get().world;
-    if (!filterIds) {
-      const bodies = Object.values(worldData).filter((entry) => entry.type === "group" && entry.rootBounds).map((entry) => {
-        const firstNs = Object.keys(entry.refs)[0];
-        const refGroup = entry.refs[firstNs].current;
-        return refGroup;
-      });
-      return bodies;
-    } else {
-      const bodies = Object.values(worldData).filter(
-        (entry) => entry.type === "group" && entry.rootBounds && filterIds.includes(entry.id)
-      ).map((entry) => {
-        const firstNs = Object.keys(entry.refs)[0];
-        const refGroup = entry.refs[firstNs].current;
-        return refGroup;
-      });
-      return bodies;
-    }
+    const candidateGroups = selectExportableGroupEntries(
+      worldData,
+      filterIds
+    );
+    return candidateGroups.flatMap((entry) => {
+      const refs = Object.values(
+        entry.refs ?? {}
+      );
+      const resolved = refs.find((ref) => ref?.current)?.current ?? null;
+      return resolved ? [resolved] : [];
+    });
   },
   setGeometry: (id, geometry) => {
     set(
@@ -2304,6 +2328,15 @@ function importMesh(mesh, namespaces, colorLookup) {
       world = { ...world, ...newWorldItems };
       animatables = { ...animatables, ...newAnimatables };
       children.push(childId);
+    } else if (shouldImportAsGroupChild(child)) {
+      const [newWorldItems, newAnimatables, childId, newMeshColors] = importGroup(child, namespaces, {
+        ...colorLookup,
+        ...newColorLookup
+      });
+      newColorLookup = { ...newColorLookup, ...newMeshColors };
+      world = { ...world, ...newWorldItems };
+      animatables = { ...animatables, ...newAnimatables };
+      children.push(childId);
     }
   });
   const newShape = {
@@ -2347,6 +2380,24 @@ function getShapeMaterial(mesh, useEmissive) {
     return "standard" /* Standard */;
   }
 }
+function shouldImportAsGroupChild(child) {
+  if (!child.isObject3D) {
+    return false;
+  }
+  if (child.isMesh) {
+    return false;
+  }
+  if (child.isCamera) {
+    return false;
+  }
+  if (child.isLight) {
+    return false;
+  }
+  if (child.isBone) {
+    return false;
+  }
+  return true;
+}
 
 // src/functions/gltf-loading/import-group.ts
 import_three4.Object3D.DEFAULT_UP.set(0, 0, 1);
@@ -2406,7 +2457,7 @@ function importGroup(group, namespaces, colorLookup, rootBounds) {
       world = { ...world, ...newWorldItems };
       animatables = { ...animatables, ...newAnimatables };
       children.push(childId);
-    } else if (child.isGroup || child.isObject3D && child.children.length !== 0) {
+    } else if (shouldImportAsGroupChild2(child)) {
       const [newWorldItems, newAnimatables, childId, newMeshColors] = importGroup(child, namespaces, {
         ...colorLookup,
         ...newColorLookup
@@ -2435,6 +2486,24 @@ function importGroup(group, namespaces, colorLookup, rootBounds) {
   world = { ...world, [newGroup.id]: newGroup };
   return [world, animatables, newGroup.id, newColorLookup];
 }
+function shouldImportAsGroupChild2(child) {
+  if (!child.isObject3D) {
+    return false;
+  }
+  if (child.isMesh) {
+    return false;
+  }
+  if (child.isCamera) {
+    return false;
+  }
+  if (child.isLight) {
+    return false;
+  }
+  if (child.isBone) {
+    return false;
+  }
+  return true;
+}
 
 // src/functions/gltf-loading/import-scene.ts
 import_three5.Object3D.DEFAULT_UP.set(0, 0, 1);
@@ -2745,6 +2814,13 @@ function searchParserJsonForBundle(parserJson) {
   if (!parserJson || typeof parserJson !== "object") {
     return null;
   }
+  const rootExtensions = parserJson && typeof parserJson === "object" ? parserJson.extensions : null;
+  if (rootExtensions && typeof rootExtensions === "object") {
+    const match = readExtensionValue(rootExtensions);
+    if (match) {
+      return cloneBundle(match.value);
+    }
+  }
   const nodes = Array.isArray(parserJson.nodes) ? parserJson.nodes : [];
   for (const node of nodes) {
     const extensions = node && typeof node === "object" ? node.extensions : null;
@@ -3180,23 +3256,94 @@ function extractVizijAnimations(parserJson, clips) {
 
 // src/functions/load-gltf.ts
 THREE5.Object3D.DEFAULT_UP.set(0, 0, 1);
+var GLB_MAGIC = 1179937895;
+var GLB_VERSION = 2;
+var GLB_HEADER_BYTES = 12;
+var GLB_CHUNK_HEADER_BYTES = 8;
+var GLB_JSON_CHUNK_TYPE = 1313821514;
 var EmptyModelError = class extends Error {
   constructor(message) {
     super(message);
     this.name = "EmptyModelError";
   }
 };
+function parseGlbJsonChunk(buffer) {
+  if (buffer.byteLength < GLB_HEADER_BYTES + GLB_CHUNK_HEADER_BYTES) {
+    return void 0;
+  }
+  const view = new DataView(buffer);
+  const magic = view.getUint32(0, true);
+  const version = view.getUint32(4, true);
+  if (magic !== GLB_MAGIC || version !== GLB_VERSION) {
+    return void 0;
+  }
+  const chunkLength = view.getUint32(GLB_HEADER_BYTES, true);
+  const chunkType = view.getUint32(GLB_HEADER_BYTES + 4, true);
+  if (chunkType !== GLB_JSON_CHUNK_TYPE) {
+    return void 0;
+  }
+  const chunkStart = GLB_HEADER_BYTES + GLB_CHUNK_HEADER_BYTES;
+  const chunkEnd = chunkStart + chunkLength;
+  if (chunkEnd > buffer.byteLength) {
+    return void 0;
+  }
+  try {
+    const chunkBytes = new Uint8Array(buffer, chunkStart, chunkLength);
+    const jsonText = new TextDecoder().decode(chunkBytes);
+    return JSON.parse(jsonText);
+  } catch {
+    return void 0;
+  }
+}
+async function resolveParserJson(parserJson, fallback) {
+  if (parserJson && typeof parserJson === "object") {
+    return parserJson;
+  }
+  if (fallback.arrayBuffer) {
+    const fromArrayBuffer = parseGlbJsonChunk(fallback.arrayBuffer);
+    if (fromArrayBuffer && typeof fromArrayBuffer === "object") {
+      return fromArrayBuffer;
+    }
+  }
+  if (fallback.blob) {
+    try {
+      const blobBuffer = typeof fallback.blob.arrayBuffer === "function" ? await fallback.blob.arrayBuffer() : await new Response(fallback.blob).arrayBuffer();
+      const fromBlob = parseGlbJsonChunk(blobBuffer);
+      if (fromBlob && typeof fromBlob === "object") {
+        return fromBlob;
+      }
+    } catch {
+    }
+  }
+  if (fallback.url && typeof fetch === "function") {
+    try {
+      const response = await fetch(fallback.url);
+      if (response.ok) {
+        const binary = await response.arrayBuffer();
+        const fromUrl = parseGlbJsonChunk(binary);
+        if (fromUrl && typeof fromUrl === "object") {
+          return fromUrl;
+        }
+      }
+    } catch {
+    }
+  }
+  return parserJson;
+}
 async function loadGLTF(url, namespaces, aggressiveImport = false, rootBounds) {
   const modelLoader = new import_three_stdlib.GLTFLoader();
   modelLoader.setDRACOLoader(new import_three_stdlib.DRACOLoader());
   const modelData = await modelLoader.loadAsync(url);
+  const parserJson = await resolveParserJson(modelData?.parser?.json, {
+    url
+  });
   const actualizedNamespaces = namespaces.length > 0 ? namespaces : ["default"];
   const asset = parseScene(
     modelData.scene,
     actualizedNamespaces,
     aggressiveImport,
     rootBounds,
-    modelData?.parser?.json,
+    parserJson,
     modelData.animations
   );
   return [asset.world, asset.animatables, asset.animations];
@@ -3210,7 +3357,8 @@ async function loadGLTFFromBlob(blob, namespaces, aggressiveImport = false, root
         objectUrl,
         actualizedNamespaces,
         aggressiveImport,
-        rootBounds
+        rootBounds,
+        { blob }
       );
       return [asset.world, asset.animatables, asset.animations];
     } finally {
@@ -3224,14 +3372,18 @@ async function loadGLTFFromBlob(blob, namespaces, aggressiveImport = false, root
     loader.parse(
       arrayBuffer,
       "",
-      (gltf) => {
+      async (gltf) => {
         try {
+          const parserJson = await resolveParserJson(
+            gltf?.parser?.json,
+            { arrayBuffer }
+          );
           const asset = parseScene(
             gltf.scene,
             actualizedNamespaces,
             aggressiveImport,
             rootBounds,
-            gltf?.parser?.json,
+            parserJson,
             gltf.animations
           );
           resolve([asset.world, asset.animatables, asset.animations]);
@@ -3258,19 +3410,23 @@ function parseScene(scene, namespaces, aggressiveImport, rootBounds, parserJson,
   );
   const bundle = extractVizijBundle(scene, parserJson);
   const animations = extractVizijAnimations(parserJson, clips);
-  return { world, animatables, bundle, animations };
+  return { world, animatables, bundle, animations, scene };
 }
-async function loadGLTFWithBundle(url, namespaces, aggressiveImport = false, rootBounds) {
+async function loadGLTFWithBundle(url, namespaces, aggressiveImport = false, rootBounds, parserJsonFallback) {
   const modelLoader = new import_three_stdlib.GLTFLoader();
   modelLoader.setDRACOLoader(new import_three_stdlib.DRACOLoader());
   const modelData = await modelLoader.loadAsync(url);
+  const parserJson = await resolveParserJson(modelData?.parser?.json, {
+    url,
+    ...parserJsonFallback
+  });
   const actualizedNamespaces = namespaces.length > 0 ? namespaces : ["default"];
   return parseScene(
     modelData.scene,
     actualizedNamespaces,
     aggressiveImport,
     rootBounds,
-    modelData?.parser?.json,
+    parserJson,
     modelData.animations
   );
 }
@@ -3283,7 +3439,8 @@ async function loadGLTFFromBlobWithBundle(blob, namespaces, aggressiveImport = f
         objectUrl,
         actualizedNamespaces,
         aggressiveImport,
-        rootBounds
+        rootBounds,
+        { blob }
       );
     } finally {
       URL.revokeObjectURL(objectUrl);
@@ -3296,14 +3453,18 @@ async function loadGLTFFromBlobWithBundle(blob, namespaces, aggressiveImport = f
     loader.parse(
       arrayBuffer,
       "",
-      (gltf) => {
+      async (gltf) => {
         try {
+          const parserJson = await resolveParserJson(
+            gltf?.parser?.json,
+            { arrayBuffer }
+          );
           const asset = parseScene(
             gltf.scene,
             actualizedNamespaces,
             aggressiveImport,
             rootBounds,
-            gltf?.parser?.json,
+            parserJson,
             gltf.animations
           );
           resolve(asset);
@@ -3355,6 +3516,160 @@ var loadGltfFromBlob = (blob, namespaces) => {
 var import_three_stdlib3 = require("three-stdlib");
 var THREE6 = __toESM(require("three"));
 THREE6.Object3D.DEFAULT_UP.set(0, 0, 1);
+function normalizeExportError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  if (typeof error === "string") {
+    return new Error(error);
+  }
+  return new Error("Failed to export scene.");
+}
+function triggerBlobDownload(blob, filename) {
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = filename;
+  link.style.display = "none";
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  setTimeout(() => URL.revokeObjectURL(url), 0);
+}
+var GLB_MAGIC2 = 1179937895;
+var GLB_VERSION2 = 2;
+var GLB_JSON_CHUNK_TYPE2 = 1313821514;
+var GLB_HEADER_BYTES2 = 12;
+var GLB_CHUNK_HEADER_BYTES2 = 8;
+var GLB_JSON_PADDING_BYTE = 32;
+function isNearlyEqual(a, b, epsilon = 1e-6) {
+  return Math.abs(a - b) <= epsilon;
+}
+function isIdentityTransformNode(node) {
+  const translation = node.translation;
+  if (Array.isArray(translation) && (translation.length !== 3 || !isNearlyEqual(Number(translation[0]), 0) || !isNearlyEqual(Number(translation[1]), 0) || !isNearlyEqual(Number(translation[2]), 0))) {
+    return false;
+  }
+  const rotation = node.rotation;
+  if (Array.isArray(rotation) && (rotation.length !== 4 || !isNearlyEqual(Number(rotation[0]), 0) || !isNearlyEqual(Number(rotation[1]), 0) || !isNearlyEqual(Number(rotation[2]), 0) || !isNearlyEqual(Number(rotation[3]), 1))) {
+    return false;
+  }
+  const scale = node.scale;
+  if (Array.isArray(scale) && (scale.length !== 3 || !isNearlyEqual(Number(scale[0]), 1) || !isNearlyEqual(Number(scale[1]), 1) || !isNearlyEqual(Number(scale[2]), 1))) {
+    return false;
+  }
+  return true;
+}
+function isPassThroughWrapperNode(node) {
+  if (!node || typeof node !== "object") {
+    return false;
+  }
+  if (!Array.isArray(node.children) || node.children.length === 0) {
+    return false;
+  }
+  const hasOnlyNumericChildren = node.children.every(
+    (index) => Number.isInteger(index)
+  );
+  if (!hasOnlyNumericChildren) {
+    return false;
+  }
+  if (node.mesh !== void 0 || node.camera !== void 0 || node.skin !== void 0) {
+    return false;
+  }
+  if (node.extensions && typeof node.extensions === "object" && Object.keys(node.extensions).length > 0) {
+    return false;
+  }
+  return isIdentityTransformNode(node);
+}
+function normalizeExportedSceneJson(json, fallbackSceneName) {
+  if (!json || typeof json !== "object") {
+    return false;
+  }
+  if (!Array.isArray(json.scenes) || !Array.isArray(json.nodes)) {
+    return false;
+  }
+  const sceneIndexRaw = json.scene;
+  const sceneIndex = typeof sceneIndexRaw === "number" && Number.isInteger(sceneIndexRaw) ? sceneIndexRaw : 0;
+  const sceneDef = json.scenes[sceneIndex];
+  if (!sceneDef || typeof sceneDef !== "object") {
+    return false;
+  }
+  let changed = false;
+  let wrapperNodeName;
+  if (Array.isArray(sceneDef.nodes) && sceneDef.nodes.length === 1) {
+    const wrapperIndex = sceneDef.nodes[0];
+    if (Number.isInteger(wrapperIndex)) {
+      const wrapperNode = json.nodes[wrapperIndex];
+      if (isPassThroughWrapperNode(wrapperNode)) {
+        sceneDef.nodes = [...wrapperNode.children];
+        wrapperNodeName = typeof wrapperNode.name === "string" ? wrapperNode.name : void 0;
+        changed = true;
+      }
+    }
+  }
+  const currentSceneName = typeof sceneDef.name === "string" ? sceneDef.name.trim() : "";
+  if (currentSceneName === "AuxScene") {
+    const nextSceneName = (wrapperNodeName?.trim() || fallbackSceneName?.trim() || "Scene").trim();
+    if (nextSceneName.length > 0 && nextSceneName !== currentSceneName) {
+      sceneDef.name = nextSceneName;
+      changed = true;
+    }
+  }
+  return changed;
+}
+function sanitizeExportedGlb(buffer, fallbackSceneName) {
+  if (buffer.byteLength < GLB_HEADER_BYTES2 + GLB_CHUNK_HEADER_BYTES2) {
+    return buffer;
+  }
+  const originalBytes = new Uint8Array(buffer);
+  const view = new DataView(buffer);
+  const magic = view.getUint32(0, true);
+  const version = view.getUint32(4, true);
+  if (magic !== GLB_MAGIC2 || version !== GLB_VERSION2) {
+    return buffer;
+  }
+  const jsonChunkLength = view.getUint32(GLB_HEADER_BYTES2, true);
+  const jsonChunkType = view.getUint32(GLB_HEADER_BYTES2 + 4, true);
+  if (jsonChunkType !== GLB_JSON_CHUNK_TYPE2) {
+    return buffer;
+  }
+  const jsonChunkStart = GLB_HEADER_BYTES2 + GLB_CHUNK_HEADER_BYTES2;
+  const jsonChunkEnd = jsonChunkStart + jsonChunkLength;
+  if (jsonChunkEnd > originalBytes.length) {
+    return buffer;
+  }
+  let jsonPayload;
+  try {
+    const jsonText = new TextDecoder().decode(
+      originalBytes.slice(jsonChunkStart, jsonChunkEnd)
+    );
+    jsonPayload = JSON.parse(jsonText);
+  } catch {
+    return buffer;
+  }
+  const changed = normalizeExportedSceneJson(jsonPayload, fallbackSceneName);
+  if (!changed) {
+    return buffer;
+  }
+  const encodedJson = new TextEncoder().encode(JSON.stringify(jsonPayload));
+  const paddedJsonLength = encodedJson.length + 3 & ~3;
+  const paddedJson = new Uint8Array(paddedJsonLength);
+  paddedJson.fill(GLB_JSON_PADDING_BYTE);
+  paddedJson.set(encodedJson);
+  const remainingChunks = originalBytes.slice(jsonChunkEnd);
+  const totalLength = GLB_HEADER_BYTES2 + GLB_CHUNK_HEADER_BYTES2 + paddedJsonLength + remainingChunks.length;
+  const sanitized = new ArrayBuffer(totalLength);
+  const sanitizedBytes = new Uint8Array(sanitized);
+  const sanitizedView = new DataView(sanitized);
+  sanitizedView.setUint32(0, GLB_MAGIC2, true);
+  sanitizedView.setUint32(4, GLB_VERSION2, true);
+  sanitizedView.setUint32(8, totalLength, true);
+  sanitizedView.setUint32(GLB_HEADER_BYTES2, paddedJsonLength, true);
+  sanitizedView.setUint32(GLB_HEADER_BYTES2 + 4, GLB_JSON_CHUNK_TYPE2, true);
+  sanitizedBytes.set(paddedJson, jsonChunkStart);
+  sanitizedBytes.set(remainingChunks, jsonChunkStart + paddedJsonLength);
+  return sanitized;
+}
 function exportScene(data, fileNameOrOptions = "scene.glb") {
   const options = typeof fileNameOrOptions === "string" ? { fileName: fileNameOrOptions } : fileNameOrOptions ?? {};
   const fileName = options.fileName ?? "scene.glb";
@@ -3369,7 +3684,15 @@ function exportScene(data, fileNameOrOptions = "scene.glb") {
       }
     }
   }));
-  const detachBundle = shouldAttachBundle && options.bundle ? applyVizijBundle(data, options.bundle) : () => {
+  const sourceRoot = data;
+  const exportRoot = sourceRoot instanceof THREE6.Scene ? sourceRoot : sourceRoot.clone(true);
+  const exportTarget = exportRoot instanceof THREE6.Scene ? exportRoot : (() => {
+    const scene = new THREE6.Scene();
+    scene.name = data.name?.trim() || "Scene";
+    scene.add(exportRoot);
+    return scene;
+  })();
+  const detachBundle = shouldAttachBundle && options.bundle ? applyVizijBundle(exportRoot, options.bundle) : () => {
   };
   const binary = options.binary ?? true;
   const exporterOptions = {
@@ -3383,33 +3706,40 @@ function exportScene(data, fileNameOrOptions = "scene.glb") {
   }
   try {
     exporter.parse(
-      data,
+      exportTarget,
       (gltf) => {
         detachBundle();
         if (!(gltf instanceof ArrayBuffer)) {
-          throw new Error("Failed to export scene!");
+          const error = new Error("Failed to export scene.");
+          options.onError?.(error);
+          return;
         }
-        const link = document.createElement("a");
-        link.href = URL.createObjectURL(
-          new Blob([gltf], {
-            type: "application/octet-stream"
-          })
+        const sanitizedGltf = sanitizeExportedGlb(
+          gltf,
+          data.name?.trim() || void 0
         );
         const trimmed = fileName.trim();
         const safeFileName = trimmed.length > 0 ? trimmed : "scene.glb";
         const downloadName = safeFileName.toLowerCase().endsWith(".glb") ? safeFileName : `${safeFileName}.glb`;
-        link.download = downloadName;
-        link.click();
-        URL.revokeObjectURL(link.href);
+        triggerBlobDownload(
+          new Blob([sanitizedGltf], {
+            type: "application/octet-stream"
+          }),
+          downloadName
+        );
+        options.onComplete?.();
       },
-      () => {
+      (error) => {
         detachBundle();
+        options.onError?.(normalizeExportError(error));
       },
       exporterOptions
     );
   } catch (error) {
     detachBundle();
-    throw error;
+    const normalizedError = normalizeExportError(error);
+    options.onError?.(normalizedError);
+    throw normalizedError;
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -3429,6 +3759,7 @@ function exportScene(data, fileNameOrOptions = "scene.glb") {
   loadGLTFFromBlobWithBundle,
   loadGLTFWithBundle,
   loadGltfFromBlob,
+  parseGlbJsonChunk,
   useDefaultVizijStore,
   useFeatures,
   useVizijStore,

package/dist/index.mjs

@@ -1403,6 +1403,35 @@ function createAnimatable(value) {
 }
 createAnimatable({ type: "euler", name: "Rotation" });
 
+// src/functions/exportable-bodies.ts
+function asGroupEntries(world) {
+  return Object.values(world).filter((entry) => entry.type === "group");
+}
+function selectExportableGroupEntries(world, filterIds) {
+  const groupEntries = asGroupEntries(world);
+  const filterSet = Array.isArray(filterIds) && filterIds.length > 0 ? new Set(filterIds) : null;
+  if (filterSet) {
+    return groupEntries.filter((entry) => filterSet.has(entry.id));
+  }
+  const rootBoundsGroups = groupEntries.filter(
+    (entry) => Boolean(entry.rootBounds)
+  );
+  if (rootBoundsGroups.length > 0) {
+    return rootBoundsGroups;
+  }
+  const explicitRootGroups = groupEntries.filter(
+    (entry) => entry.root === true
+  );
+  if (explicitRootGroups.length > 0) {
+    return explicitRootGroups;
+  }
+  const topLevelGroups = groupEntries.filter((entry) => !entry.parent);
+  if (topLevelGroups.length > 0) {
+    return topLevelGroups;
+  }
+  return groupEntries;
+}
+
 // src/store.ts
 THREE3.Object3D.DEFAULT_UP.set(0, 0, 1);
 enableMapSet();
@@ -1478,23 +1507,17 @@ var VizijSlice = (set, get) => ({
   },
   getExportableBodies: (filterIds) => {
     const worldData = get().world;
-    if (!filterIds) {
-      const bodies = Object.values(worldData).filter((entry) => entry.type === "group" && entry.rootBounds).map((entry) => {
-        const firstNs = Object.keys(entry.refs)[0];
-        const refGroup = entry.refs[firstNs].current;
-        return refGroup;
-      });
-      return bodies;
-    } else {
-      const bodies = Object.values(worldData).filter(
-        (entry) => entry.type === "group" && entry.rootBounds && filterIds.includes(entry.id)
-      ).map((entry) => {
-        const firstNs = Object.keys(entry.refs)[0];
-        const refGroup = entry.refs[firstNs].current;
-        return refGroup;
-      });
-      return bodies;
-    }
+    const candidateGroups = selectExportableGroupEntries(
+      worldData,
+      filterIds
+    );
+    return candidateGroups.flatMap((entry) => {
+      const refs = Object.values(
+        entry.refs ?? {}
+      );
+      const resolved = refs.find((ref) => ref?.current)?.current ?? null;
+      return resolved ? [resolved] : [];
+    });
   },
   setGeometry: (id, geometry) => {
     set(
@@ -2281,6 +2304,15 @@ function importMesh(mesh, namespaces, colorLookup) {
       world = { ...world, ...newWorldItems };
       animatables = { ...animatables, ...newAnimatables };
       children.push(childId);
+    } else if (shouldImportAsGroupChild(child)) {
+      const [newWorldItems, newAnimatables, childId, newMeshColors] = importGroup(child, namespaces, {
+        ...colorLookup,
+        ...newColorLookup
+      });
+      newColorLookup = { ...newColorLookup, ...newMeshColors };
+      world = { ...world, ...newWorldItems };
+      animatables = { ...animatables, ...newAnimatables };
+      children.push(childId);
     }
   });
   const newShape = {
@@ -2324,6 +2356,24 @@ function getShapeMaterial(mesh, useEmissive) {
     return "standard" /* Standard */;
   }
 }
+function shouldImportAsGroupChild(child) {
+  if (!child.isObject3D) {
+    return false;
+  }
+  if (child.isMesh) {
+    return false;
+  }
+  if (child.isCamera) {
+    return false;
+  }
+  if (child.isLight) {
+    return false;
+  }
+  if (child.isBone) {
+    return false;
+  }
+  return true;
+}
 
 // src/functions/gltf-loading/import-group.ts
 Object3D6.DEFAULT_UP.set(0, 0, 1);
@@ -2383,7 +2433,7 @@ function importGroup(group, namespaces, colorLookup, rootBounds) {
       world = { ...world, ...newWorldItems };
       animatables = { ...animatables, ...newAnimatables };
       children.push(childId);
-    } else if (child.isGroup || child.isObject3D && child.children.length !== 0) {
+    } else if (shouldImportAsGroupChild2(child)) {
       const [newWorldItems, newAnimatables, childId, newMeshColors] = importGroup(child, namespaces, {
         ...colorLookup,
         ...newColorLookup
@@ -2412,6 +2462,24 @@ function importGroup(group, namespaces, colorLookup, rootBounds) {
   world = { ...world, [newGroup.id]: newGroup };
   return [world, animatables, newGroup.id, newColorLookup];
 }
+function shouldImportAsGroupChild2(child) {
+  if (!child.isObject3D) {
+    return false;
+  }
+  if (child.isMesh) {
+    return false;
+  }
+  if (child.isCamera) {
+    return false;
+  }
+  if (child.isLight) {
+    return false;
+  }
+  if (child.isBone) {
+    return false;
+  }
+  return true;
+}
 
 // src/functions/gltf-loading/import-scene.ts
 Object3D7.DEFAULT_UP.set(0, 0, 1);
@@ -2722,6 +2790,13 @@ function searchParserJsonForBundle(parserJson) {
   if (!parserJson || typeof parserJson !== "object") {
     return null;
   }
+  const rootExtensions = parserJson && typeof parserJson === "object" ? parserJson.extensions : null;
+  if (rootExtensions && typeof rootExtensions === "object") {
+    const match = readExtensionValue(rootExtensions);
+    if (match) {
+      return cloneBundle(match.value);
+    }
+  }
   const nodes = Array.isArray(parserJson.nodes) ? parserJson.nodes : [];
   for (const node of nodes) {
     const extensions = node && typeof node === "object" ? node.extensions : null;
@@ -3157,23 +3232,94 @@ function extractVizijAnimations(parserJson, clips) {
 
 // src/functions/load-gltf.ts
 THREE5.Object3D.DEFAULT_UP.set(0, 0, 1);
+var GLB_MAGIC = 1179937895;
+var GLB_VERSION = 2;
+var GLB_HEADER_BYTES = 12;
+var GLB_CHUNK_HEADER_BYTES = 8;
+var GLB_JSON_CHUNK_TYPE = 1313821514;
 var EmptyModelError = class extends Error {
   constructor(message) {
     super(message);
     this.name = "EmptyModelError";
   }
 };
+function parseGlbJsonChunk(buffer) {
+  if (buffer.byteLength < GLB_HEADER_BYTES + GLB_CHUNK_HEADER_BYTES) {
+    return void 0;
+  }
+  const view = new DataView(buffer);
+  const magic = view.getUint32(0, true);
+  const version = view.getUint32(4, true);
+  if (magic !== GLB_MAGIC || version !== GLB_VERSION) {
+    return void 0;
+  }
+  const chunkLength = view.getUint32(GLB_HEADER_BYTES, true);
+  const chunkType = view.getUint32(GLB_HEADER_BYTES + 4, true);
+  if (chunkType !== GLB_JSON_CHUNK_TYPE) {
+    return void 0;
+  }
+  const chunkStart = GLB_HEADER_BYTES + GLB_CHUNK_HEADER_BYTES;
+  const chunkEnd = chunkStart + chunkLength;
+  if (chunkEnd > buffer.byteLength) {
+    return void 0;
+  }
+  try {
+    const chunkBytes = new Uint8Array(buffer, chunkStart, chunkLength);
+    const jsonText = new TextDecoder().decode(chunkBytes);
+    return JSON.parse(jsonText);
+  } catch {
+    return void 0;
+  }
+}
+async function resolveParserJson(parserJson, fallback) {
+  if (parserJson && typeof parserJson === "object") {
+    return parserJson;
+  }
+  if (fallback.arrayBuffer) {
+    const fromArrayBuffer = parseGlbJsonChunk(fallback.arrayBuffer);
+    if (fromArrayBuffer && typeof fromArrayBuffer === "object") {
+      return fromArrayBuffer;
+    }
+  }
+  if (fallback.blob) {
+    try {
+      const blobBuffer = typeof fallback.blob.arrayBuffer === "function" ? await fallback.blob.arrayBuffer() : await new Response(fallback.blob).arrayBuffer();
+      const fromBlob = parseGlbJsonChunk(blobBuffer);
+      if (fromBlob && typeof fromBlob === "object") {
+        return fromBlob;
+      }
+    } catch {
+    }
+  }
+  if (fallback.url && typeof fetch === "function") {
+    try {
+      const response = await fetch(fallback.url);
+      if (response.ok) {
+        const binary = await response.arrayBuffer();
+        const fromUrl = parseGlbJsonChunk(binary);
+        if (fromUrl && typeof fromUrl === "object") {
+          return fromUrl;
+        }
+      }
+    } catch {
+    }
+  }
+  return parserJson;
+}
 async function loadGLTF(url, namespaces, aggressiveImport = false, rootBounds) {
   const modelLoader = new GLTFLoader();
   modelLoader.setDRACOLoader(new DRACOLoader());
   const modelData = await modelLoader.loadAsync(url);
+  const parserJson = await resolveParserJson(modelData?.parser?.json, {
+    url
+  });
   const actualizedNamespaces = namespaces.length > 0 ? namespaces : ["default"];
   const asset = parseScene(
     modelData.scene,
     actualizedNamespaces,
     aggressiveImport,
     rootBounds,
-    modelData?.parser?.json,
+    parserJson,
     modelData.animations
   );
   return [asset.world, asset.animatables, asset.animations];
@@ -3187,7 +3333,8 @@ async function loadGLTFFromBlob(blob, namespaces, aggressiveImport = false, root
         objectUrl,
         actualizedNamespaces,
         aggressiveImport,
-        rootBounds
+        rootBounds,
+        { blob }
       );
       return [asset.world, asset.animatables, asset.animations];
     } finally {
@@ -3201,14 +3348,18 @@ async function loadGLTFFromBlob(blob, namespaces, aggressiveImport = false, root
     loader.parse(
       arrayBuffer,
       "",
-      (gltf) => {
+      async (gltf) => {
         try {
+          const parserJson = await resolveParserJson(
+            gltf?.parser?.json,
+            { arrayBuffer }
+          );
           const asset = parseScene(
             gltf.scene,
             actualizedNamespaces,
             aggressiveImport,
             rootBounds,
-            gltf?.parser?.json,
+            parserJson,
             gltf.animations
           );
           resolve([asset.world, asset.animatables, asset.animations]);
@@ -3235,19 +3386,23 @@ function parseScene(scene, namespaces, aggressiveImport, rootBounds, parserJson,
   );
   const bundle = extractVizijBundle(scene, parserJson);
   const animations = extractVizijAnimations(parserJson, clips);
-  return { world, animatables, bundle, animations };
+  return { world, animatables, bundle, animations, scene };
 }
-async function loadGLTFWithBundle(url, namespaces, aggressiveImport = false, rootBounds) {
+async function loadGLTFWithBundle(url, namespaces, aggressiveImport = false, rootBounds, parserJsonFallback) {
   const modelLoader = new GLTFLoader();
   modelLoader.setDRACOLoader(new DRACOLoader());
   const modelData = await modelLoader.loadAsync(url);
+  const parserJson = await resolveParserJson(modelData?.parser?.json, {
+    url,
+    ...parserJsonFallback
+  });
   const actualizedNamespaces = namespaces.length > 0 ? namespaces : ["default"];
   return parseScene(
     modelData.scene,
     actualizedNamespaces,
     aggressiveImport,
     rootBounds,
-    modelData?.parser?.json,
+    parserJson,
     modelData.animations
   );
 }
@@ -3260,7 +3415,8 @@ async function loadGLTFFromBlobWithBundle(blob, namespaces, aggressiveImport = f
         objectUrl,
         actualizedNamespaces,
         aggressiveImport,
-        rootBounds
+        rootBounds,
+        { blob }
       );
     } finally {
       URL.revokeObjectURL(objectUrl);
@@ -3273,14 +3429,18 @@ async function loadGLTFFromBlobWithBundle(blob, namespaces, aggressiveImport = f
     loader.parse(
       arrayBuffer,
       "",
-      (gltf) => {
+      async (gltf) => {
         try {
+          const parserJson = await resolveParserJson(
+            gltf?.parser?.json,
+            { arrayBuffer }
+          );
           const asset = parseScene(
             gltf.scene,
             actualizedNamespaces,
             aggressiveImport,
             rootBounds,
-            gltf?.parser?.json,
+            parserJson,
             gltf.animations
           );
           resolve(asset);
@@ -3332,6 +3492,160 @@ var loadGltfFromBlob = (blob, namespaces) => {
 import { GLTFExporter } from "three-stdlib";
 import * as THREE6 from "three";
 THREE6.Object3D.DEFAULT_UP.set(0, 0, 1);
+function normalizeExportError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  if (typeof error === "string") {
+    return new Error(error);
+  }
+  return new Error("Failed to export scene.");
+}
+function triggerBlobDownload(blob, filename) {
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = filename;
+  link.style.display = "none";
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  setTimeout(() => URL.revokeObjectURL(url), 0);
+}
+var GLB_MAGIC2 = 1179937895;
+var GLB_VERSION2 = 2;
+var GLB_JSON_CHUNK_TYPE2 = 1313821514;
+var GLB_HEADER_BYTES2 = 12;
+var GLB_CHUNK_HEADER_BYTES2 = 8;
+var GLB_JSON_PADDING_BYTE = 32;
+function isNearlyEqual(a, b, epsilon = 1e-6) {
+  return Math.abs(a - b) <= epsilon;
+}
+function isIdentityTransformNode(node) {
+  const translation = node.translation;
+  if (Array.isArray(translation) && (translation.length !== 3 || !isNearlyEqual(Number(translation[0]), 0) || !isNearlyEqual(Number(translation[1]), 0) || !isNearlyEqual(Number(translation[2]), 0))) {
+    return false;
+  }
+  const rotation = node.rotation;
+  if (Array.isArray(rotation) && (rotation.length !== 4 || !isNearlyEqual(Number(rotation[0]), 0) || !isNearlyEqual(Number(rotation[1]), 0) || !isNearlyEqual(Number(rotation[2]), 0) || !isNearlyEqual(Number(rotation[3]), 1))) {
+    return false;
+  }
+  const scale = node.scale;
+  if (Array.isArray(scale) && (scale.length !== 3 || !isNearlyEqual(Number(scale[0]), 1) || !isNearlyEqual(Number(scale[1]), 1) || !isNearlyEqual(Number(scale[2]), 1))) {
+    return false;
+  }
+  return true;
+}
+function isPassThroughWrapperNode(node) {
+  if (!node || typeof node !== "object") {
+    return false;
+  }
+  if (!Array.isArray(node.children) || node.children.length === 0) {
+    return false;
+  }
+  const hasOnlyNumericChildren = node.children.every(
+    (index) => Number.isInteger(index)
+  );
+  if (!hasOnlyNumericChildren) {
+    return false;
+  }
+  if (node.mesh !== void 0 || node.camera !== void 0 || node.skin !== void 0) {
+    return false;
+  }
+  if (node.extensions && typeof node.extensions === "object" && Object.keys(node.extensions).length > 0) {
+    return false;
+  }
+  return isIdentityTransformNode(node);
+}
+function normalizeExportedSceneJson(json, fallbackSceneName) {
+  if (!json || typeof json !== "object") {
+    return false;
+  }
+  if (!Array.isArray(json.scenes) || !Array.isArray(json.nodes)) {
+    return false;
+  }
+  const sceneIndexRaw = json.scene;
+  const sceneIndex = typeof sceneIndexRaw === "number" && Number.isInteger(sceneIndexRaw) ? sceneIndexRaw : 0;
+  const sceneDef = json.scenes[sceneIndex];
+  if (!sceneDef || typeof sceneDef !== "object") {
+    return false;
+  }
+  let changed = false;
+  let wrapperNodeName;
+  if (Array.isArray(sceneDef.nodes) && sceneDef.nodes.length === 1) {
+    const wrapperIndex = sceneDef.nodes[0];
+    if (Number.isInteger(wrapperIndex)) {
+      const wrapperNode = json.nodes[wrapperIndex];
+      if (isPassThroughWrapperNode(wrapperNode)) {
+        sceneDef.nodes = [...wrapperNode.children];
+        wrapperNodeName = typeof wrapperNode.name === "string" ? wrapperNode.name : void 0;
+        changed = true;
+      }
+    }
+  }
+  const currentSceneName = typeof sceneDef.name === "string" ? sceneDef.name.trim() : "";
+  if (currentSceneName === "AuxScene") {
+    const nextSceneName = (wrapperNodeName?.trim() || fallbackSceneName?.trim() || "Scene").trim();
+    if (nextSceneName.length > 0 && nextSceneName !== currentSceneName) {
+      sceneDef.name = nextSceneName;
+      changed = true;
+    }
+  }
+  return changed;
+}
+function sanitizeExportedGlb(buffer, fallbackSceneName) {
+  if (buffer.byteLength < GLB_HEADER_BYTES2 + GLB_CHUNK_HEADER_BYTES2) {
+    return buffer;
+  }
+  const originalBytes = new Uint8Array(buffer);
+  const view = new DataView(buffer);
+  const magic = view.getUint32(0, true);
+  const version = view.getUint32(4, true);
+  if (magic !== GLB_MAGIC2 || version !== GLB_VERSION2) {
+    return buffer;
+  }
+  const jsonChunkLength = view.getUint32(GLB_HEADER_BYTES2, true);
+  const jsonChunkType = view.getUint32(GLB_HEADER_BYTES2 + 4, true);
+  if (jsonChunkType !== GLB_JSON_CHUNK_TYPE2) {
+    return buffer;
+  }
+  const jsonChunkStart = GLB_HEADER_BYTES2 + GLB_CHUNK_HEADER_BYTES2;
+  const jsonChunkEnd = jsonChunkStart + jsonChunkLength;
+  if (jsonChunkEnd > originalBytes.length) {
+    return buffer;
+  }
+  let jsonPayload;
+  try {
+    const jsonText = new TextDecoder().decode(
+      originalBytes.slice(jsonChunkStart, jsonChunkEnd)
+    );
+    jsonPayload = JSON.parse(jsonText);
+  } catch {
+    return buffer;
+  }
+  const changed = normalizeExportedSceneJson(jsonPayload, fallbackSceneName);
+  if (!changed) {
+    return buffer;
+  }
+  const encodedJson = new TextEncoder().encode(JSON.stringify(jsonPayload));
+  const paddedJsonLength = encodedJson.length + 3 & ~3;
+  const paddedJson = new Uint8Array(paddedJsonLength);
+  paddedJson.fill(GLB_JSON_PADDING_BYTE);
+  paddedJson.set(encodedJson);
+  const remainingChunks = originalBytes.slice(jsonChunkEnd);
+  const totalLength = GLB_HEADER_BYTES2 + GLB_CHUNK_HEADER_BYTES2 + paddedJsonLength + remainingChunks.length;
+  const sanitized = new ArrayBuffer(totalLength);
+  const sanitizedBytes = new Uint8Array(sanitized);
+  const sanitizedView = new DataView(sanitized);
+  sanitizedView.setUint32(0, GLB_MAGIC2, true);
+  sanitizedView.setUint32(4, GLB_VERSION2, true);
+  sanitizedView.setUint32(8, totalLength, true);
+  sanitizedView.setUint32(GLB_HEADER_BYTES2, paddedJsonLength, true);
+  sanitizedView.setUint32(GLB_HEADER_BYTES2 + 4, GLB_JSON_CHUNK_TYPE2, true);
+  sanitizedBytes.set(paddedJson, jsonChunkStart);
+  sanitizedBytes.set(remainingChunks, jsonChunkStart + paddedJsonLength);
+  return sanitized;
+}
 function exportScene(data, fileNameOrOptions = "scene.glb") {
   const options = typeof fileNameOrOptions === "string" ? { fileName: fileNameOrOptions } : fileNameOrOptions ?? {};
   const fileName = options.fileName ?? "scene.glb";
@@ -3346,7 +3660,15 @@ function exportScene(data, fileNameOrOptions = "scene.glb") {
       }
     }
   }));
-  const detachBundle = shouldAttachBundle && options.bundle ? applyVizijBundle(data, options.bundle) : () => {
+  const sourceRoot = data;
+  const exportRoot = sourceRoot instanceof THREE6.Scene ? sourceRoot : sourceRoot.clone(true);
+  const exportTarget = exportRoot instanceof THREE6.Scene ? exportRoot : (() => {
+    const scene = new THREE6.Scene();
+    scene.name = data.name?.trim() || "Scene";
+    scene.add(exportRoot);
+    return scene;
+  })();
+  const detachBundle = shouldAttachBundle && options.bundle ? applyVizijBundle(exportRoot, options.bundle) : () => {
   };
   const binary = options.binary ?? true;
   const exporterOptions = {
@@ -3360,33 +3682,40 @@ function exportScene(data, fileNameOrOptions = "scene.glb") {
   }
   try {
     exporter.parse(
-      data,
+      exportTarget,
       (gltf) => {
         detachBundle();
         if (!(gltf instanceof ArrayBuffer)) {
-          throw new Error("Failed to export scene!");
+          const error = new Error("Failed to export scene.");
+          options.onError?.(error);
+          return;
         }
-        const link = document.createElement("a");
-        link.href = URL.createObjectURL(
-          new Blob([gltf], {
-            type: "application/octet-stream"
-          })
+        const sanitizedGltf = sanitizeExportedGlb(
+          gltf,
+          data.name?.trim() || void 0
         );
         const trimmed = fileName.trim();
         const safeFileName = trimmed.length > 0 ? trimmed : "scene.glb";
         const downloadName = safeFileName.toLowerCase().endsWith(".glb") ? safeFileName : `${safeFileName}.glb`;
-        link.download = downloadName;
-        link.click();
-        URL.revokeObjectURL(link.href);
+        triggerBlobDownload(
+          new Blob([sanitizedGltf], {
+            type: "application/octet-stream"
+          }),
+          downloadName
+        );
+        options.onComplete?.();
       },
-      () => {
+      (error) => {
         detachBundle();
+        options.onError?.(normalizeExportError(error));
       },
       exporterOptions
     );
   } catch (error) {
     detachBundle();
-    throw error;
+    const normalizedError = normalizeExportError(error);
+    options.onError?.(normalizedError);
+    throw normalizedError;
   }
 }
 export {
@@ -3405,6 +3734,7 @@ export {
   loadGLTFFromBlobWithBundle,
   loadGLTFWithBundle,
   loadGltfFromBlob,
+  parseGlbJsonChunk,
   useDefaultVizijStore,
   useFeatures,
   useVizijStore,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vizij/render",
   "description": "Higher-level visualization and interaction components for robot and ai faces.",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -76,7 +76,7 @@
     "lint:fix": "pnpm --filter \"$npm_package_name\" exec eslint --ext .js,.jsx,.ts,.tsx --fix -- .",
     "prettier:check": "prettier --check .",
     "prettier:write": "prettier --write .",
-    "test": "node --loader ./tests/node-ts-loader.mjs --test tests/*.node-test.mjs",
+    "test": "node --import ./tests/register-ts-loader.mjs --test tests/*.node-test.mjs",
     "clean": "rm -rf dist .turbo coverage tsconfig.tsbuildinfo",
     "reset": "rm -rf node_modules",
     "reset:hard": "pnpm run reset && rm -f pnpm-lock.yaml package-lock.json yarn.lock",