@vizij/runtime-react 0.0.1 → 0.0.3

package/README.md

@@ -56,12 +56,13 @@ The provider creates a renderer store, boots the orchestrator, registers the sup
 
 `VizijRuntimeProvider` expects a `VizijAssetBundle`:
 
-- `glb`: required. Either `{ kind: "url", src }`, `{ kind: "blob", blob }`, or `{ kind: "world", world, animatables }`. URL/blob variants can opt into `aggressiveImport` for tooling builds and provide `rootBounds` overrides when the GLB lacks metadata.
-- `rig`: required. Graph specification describing inputs/outputs for the orchestrator (`id` must be unique within the namespace).
-- `pose`: optional. Supply authoring pose graph/config so the runtime can neutralise the rig before you drive it.
-- `animations`: optional array. Each item defines channels that map to runtime input paths. Use `playAnimation` to trigger them.
+- `glb`: required. Either `{ kind: "url", src }`, `{ kind: "blob", blob }`, or `{ kind: "world", world, animatables, bundle? }`. URL/blob variants can opt into `aggressiveImport` for tooling builds and provide `rootBounds` overrides when the GLB lacks metadata.
+- `rig`: optional. When omitted, the runtime looks for a `VIZIJ_bundle` extension inside the GLB and registers the first rig graph it finds.
+- `pose`: optional. Provide your own pose graph/config or just a `stageNeutralFilter`; bundled pose data is pulled from the GLB when present.
+- `animations`: optional array. Explicit entries merge with animations discovered in the GLB bundle (deduped by id). Use `playAnimation` to trigger them.
 - `initialInputs`: optional map of ValueJSON that seeds inputs before autostart.
 - `metadata`: free-form dictionary you can read back through `useVizijRuntime().assetBundle.metadata`.
+- `bundle`: optional. Supply pre-parsed bundle metadata when you manage world loading yourself. When loading from GLB/Blob the runtime fills this with the extracted `VizijBundleExtension`.
 
 Namespace defaults to `assetBundle.namespace ?? "default"`. Face id falls back to the bundle pose config when omitted.
 
@@ -117,9 +118,9 @@ For ad-hoc gestures, use `animateValue` with duration/easing. If you need custom
 
 ## Asset Bundling Workflow
 
-1. Export an authoring scene to GLB with Vizij metadata intact (bounds, animatable ids).
-2. Export orchestrator graphs (rig, pose, optional animation graphs) to JSON.
-3. Package everything under a namespace in a `VizijAssetBundle`.
+1. Export an authoring scene to GLB with Vizij metadata intact (bounds, animatable ids). Enable “Embed Vizij bundle” in vizij-authoring to persist rig graphs, pose rig data, and animations inside the GLB.
+2. Drop the GLB into a `VizijAssetBundle` and let the runtime extract rig/pose/animation data automatically.
+3. Optionally override or extend bundle contents by setting `rig`, `pose`, or `animations` manually (useful for tooling builds or custom staging).
 4. Host GLB URLs or include them via bundler asset imports (`new URL("./face.glb", import.meta.url).href`).
 
 The runtime tolerates incremental bundles; swap `assetBundle` props to hot-reload assets in dev builds.

package/dist/index.d.mts

@@ -3,7 +3,7 @@ import * as react from 'react';
 import { ReactNode, PropsWithChildren } from 'react';
 import { GraphRegistrationConfig, GraphSubscriptions, AnimationSetup, ValueJSON, CreateOrchOptions, MergeStrategyOptions, ShapeJSON } from '@vizij/orchestrator-react';
 import { AnimatableValue, RawValue } from '@vizij/utils';
-import { World, VizijProps } from '@vizij/render';
+import { World, VizijBundleExtension, VizijProps } from '@vizij/render';
 
 type PoseDefinition = {
     id: string;
@@ -45,6 +45,7 @@ type VizijGlbAsset = {
     kind: "world";
     world: World;
     animatables: Record<string, AnimatableValue>;
+    bundle?: VizijBundleExtension | null;
 };
 type VizijGraphAsset = {
     id: string;
@@ -76,7 +77,7 @@ type VizijAssetBundle = {
     namespace?: string;
     faceId?: string;
     glb: VizijGlbAsset;
-    rig: VizijGraphAsset;
+    rig?: VizijGraphAsset;
     pose?: {
         graph?: VizijGraphAsset;
         config?: PoseRigConfig;
@@ -85,6 +86,7 @@ type VizijAssetBundle = {
     animations?: VizijAnimationAsset[];
     initialInputs?: Record<string, ValueJSON>;
     metadata?: Record<string, unknown>;
+    bundle?: VizijBundleExtension | null;
 };
 type RuntimeError = {
     message: string;

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import * as react from 'react';
 import { ReactNode, PropsWithChildren } from 'react';
 import { GraphRegistrationConfig, GraphSubscriptions, AnimationSetup, ValueJSON, CreateOrchOptions, MergeStrategyOptions, ShapeJSON } from '@vizij/orchestrator-react';
 import { AnimatableValue, RawValue } from '@vizij/utils';
-import { World, VizijProps } from '@vizij/render';
+import { World, VizijBundleExtension, VizijProps } from '@vizij/render';
 
 type PoseDefinition = {
     id: string;
@@ -45,6 +45,7 @@ type VizijGlbAsset = {
     kind: "world";
     world: World;
     animatables: Record<string, AnimatableValue>;
+    bundle?: VizijBundleExtension | null;
 };
 type VizijGraphAsset = {
     id: string;
@@ -76,7 +77,7 @@ type VizijAssetBundle = {
     namespace?: string;
     faceId?: string;
     glb: VizijGlbAsset;
-    rig: VizijGraphAsset;
+    rig?: VizijGraphAsset;
     pose?: {
         graph?: VizijGraphAsset;
         config?: PoseRigConfig;
@@ -85,6 +86,7 @@ type VizijAssetBundle = {
     animations?: VizijAnimationAsset[];
     initialInputs?: Record<string, ValueJSON>;
     metadata?: Record<string, unknown>;
+    bundle?: VizijBundleExtension | null;
 };
 type RuntimeError = {
     message: string;

package/dist/index.js

@@ -214,7 +214,6 @@ function valueJSONToRaw(value) {
 }
 
 // src/VizijRuntimeProvider.tsx
-var import_render2 = require("@vizij/render");
 var import_jsx_runtime = require("react/jsx-runtime");
 var DEFAULT_MERGE = {
   outputs: "add",
@@ -250,6 +249,128 @@ function normalisePath(path) {
   }
   return path.startsWith("debug/") ? path.slice("debug/".length) : path;
 }
+function normaliseBundleKind(kind) {
+  return typeof kind === "string" ? kind.toLowerCase() : "";
+}
+function pickBundleGraph(bundle, preferredKinds) {
+  if (!bundle?.graphs || bundle.graphs.length === 0) {
+    return null;
+  }
+  const preferred = preferredKinds.map((kind) => kind.toLowerCase());
+  for (const entry of bundle.graphs) {
+    if (!entry || typeof entry !== "object") {
+      continue;
+    }
+    const kind = normaliseBundleKind(entry.kind);
+    if (preferred.includes(kind)) {
+      return entry;
+    }
+  }
+  if (bundle.graphs.length === 1) {
+    return bundle.graphs[0] ?? null;
+  }
+  return null;
+}
+function convertBundleGraph(entry) {
+  if (!entry || !entry.id || !entry.spec) {
+    return null;
+  }
+  return {
+    id: entry.id,
+    spec: entry.spec
+  };
+}
+function convertBundleAnimations(entries) {
+  if (!Array.isArray(entries) || entries.length === 0) {
+    return [];
+  }
+  return entries.filter(
+    (entry) => Boolean(entry && typeof entry.id === "string" && entry.clip)
+  ).map((entry) => ({
+    id: entry.id,
+    clip: entry.clip
+  }));
+}
+function mergeAnimationLists(explicit, fromBundle) {
+  if (!explicit?.length && fromBundle.length === 0) {
+    return void 0;
+  }
+  if (!explicit?.length) {
+    return fromBundle.length > 0 ? fromBundle : void 0;
+  }
+  if (fromBundle.length === 0) {
+    return explicit;
+  }
+  const seen = new Set(explicit.map((anim) => anim.id));
+  let changed = false;
+  const merged = [...explicit];
+  for (const anim of fromBundle) {
+    if (!anim.id || seen.has(anim.id)) {
+      continue;
+    }
+    merged.push(anim);
+    seen.add(anim.id);
+    changed = true;
+  }
+  return changed ? merged : explicit;
+}
+function mergeAssetBundle(base, extracted) {
+  const resolvedBundle = base.bundle ?? extracted ?? null;
+  const rigFromBundle = convertBundleGraph(
+    pickBundleGraph(resolvedBundle, ["rig"])
+  );
+  const resolvedRig = base.rig ?? rigFromBundle ?? void 0;
+  const basePose = base.pose;
+  const poseStageFilter = basePose?.stageNeutralFilter;
+  const poseGraphFromBundle = basePose?.graph ? null : convertBundleGraph(
+    pickBundleGraph(resolvedBundle, ["pose-driver", "pose"])
+  );
+  const resolvedPoseGraph = basePose?.graph ?? poseGraphFromBundle ?? void 0;
+  const resolvedPoseConfig = basePose?.config ?? resolvedBundle?.poses?.config ?? void 0;
+  let resolvedPose = basePose;
+  if (basePose) {
+    const nextPose = { ...basePose };
+    let changed = false;
+    if (resolvedPoseGraph && basePose.graph !== resolvedPoseGraph) {
+      nextPose.graph = resolvedPoseGraph;
+      changed = true;
+    }
+    if (resolvedPoseConfig && basePose.config !== resolvedPoseConfig) {
+      nextPose.config = resolvedPoseConfig;
+      changed = true;
+    }
+    if (!resolvedPoseGraph && !basePose.graph) {
+    }
+    if (!resolvedPoseConfig && !basePose.config) {
+    }
+    resolvedPose = changed ? nextPose : basePose;
+  } else if (resolvedPoseGraph || resolvedPoseConfig || typeof poseStageFilter === "function") {
+    resolvedPose = {
+      ...resolvedPoseGraph ? { graph: resolvedPoseGraph } : {},
+      ...resolvedPoseConfig ? { config: resolvedPoseConfig } : {},
+      ...typeof poseStageFilter === "function" ? { stageNeutralFilter: poseStageFilter } : {}
+    };
+  }
+  const animationsFromBundle = convertBundleAnimations(
+    resolvedBundle?.animations
+  );
+  const resolvedAnimations = mergeAnimationLists(
+    base.animations,
+    animationsFromBundle
+  );
+  const merged = {
+    ...base
+  };
+  if (resolvedRig) {
+    merged.rig = resolvedRig;
+  } else {
+    merged.rig = void 0;
+  }
+  merged.pose = resolvedPose;
+  merged.animations = resolvedAnimations;
+  merged.bundle = resolvedBundle;
+  return merged;
+}
 function VizijRuntimeProvider({
   assetBundle,
   children,
@@ -290,7 +411,7 @@ function VizijRuntimeProvider({
   ) });
 }
 function VizijRuntimeProviderInner({
-  assetBundle,
+  assetBundle: initialAssetBundle,
   namespace: namespaceProp,
   faceId: faceIdProp,
   mergeStrategy,
@@ -300,6 +421,30 @@ function VizijRuntimeProviderInner({
   children,
   autoCreate
 }) {
+  const [extractedBundle, setExtractedBundle] = (0, import_react2.useState)(() => {
+    if (initialAssetBundle.bundle) {
+      return initialAssetBundle.bundle;
+    }
+    if (initialAssetBundle.glb.kind === "world" && initialAssetBundle.glb.bundle) {
+      return initialAssetBundle.glb.bundle;
+    }
+    return null;
+  });
+  (0, import_react2.useEffect)(() => {
+    if (initialAssetBundle.bundle) {
+      setExtractedBundle(initialAssetBundle.bundle);
+      return;
+    }
+    if (initialAssetBundle.glb.kind === "world") {
+      setExtractedBundle(initialAssetBundle.glb.bundle ?? null);
+    } else {
+      setExtractedBundle(null);
+    }
+  }, [initialAssetBundle]);
+  const assetBundle = (0, import_react2.useMemo)(
+    () => mergeAssetBundle(initialAssetBundle, extractedBundle),
+    [initialAssetBundle, extractedBundle]
+  );
   const {
     ready,
     createOrchestrator,
@@ -419,27 +564,36 @@ function VizijRuntimeProviderInner({
       try {
         let world;
         let animatables;
+        let bundle = assetBundle.bundle ?? null;
         if (assetBundle.glb.kind === "url") {
-          [world, animatables] = await (0, import_render2.loadGLTF)(
+          const loaded = await (0, import_render.loadGLTFWithBundle)(
             assetBundle.glb.src,
             [namespace],
             assetBundle.glb.aggressiveImport ?? false,
             assetBundle.glb.rootBounds
           );
+          world = loaded.world;
+          animatables = loaded.animatables;
+          bundle = loaded.bundle ?? bundle;
         } else if (assetBundle.glb.kind === "blob") {
-          [world, animatables] = await (0, import_render2.loadGLTFFromBlob)(
+          const loaded = await (0, import_render.loadGLTFFromBlobWithBundle)(
             assetBundle.glb.blob,
             [namespace],
             assetBundle.glb.aggressiveImport ?? false,
             assetBundle.glb.rootBounds
           );
+          world = loaded.world;
+          animatables = loaded.animatables;
+          bundle = loaded.bundle ?? bundle;
         } else {
           world = assetBundle.glb.world;
           animatables = assetBundle.glb.animatables;
+          bundle = assetBundle.glb.bundle ?? bundle;
         }
         if (cancelled) {
           return;
         }
+        setExtractedBundle(bundle ?? null);
         const rootId = findRootId(world);
         store.getState().addWorldElements(world, animatables, true);
         reportStatus((prev) => ({
@@ -476,7 +630,8 @@ function VizijRuntimeProviderInner({
     store,
     pushError,
     reportStatus,
-    resetErrors
+    resetErrors,
+    setExtractedBundle
   ]);
   (0, import_react2.useEffect)(() => {
     if (!ready && autoCreate) {
@@ -492,15 +647,25 @@ function VizijRuntimeProviderInner({
   }, [ready, autoCreate, createOrchestrator, pushError]);
   const registerControllers = (0, import_react2.useCallback)(async () => {
     const normalize = (spec) => spec;
-    const rigSpec = normalize(assetBundle.rig.spec);
+    clearControllers();
+    const rigAsset = assetBundle.rig;
+    if (!rigAsset) {
+      pushError({
+        message: "Asset bundle is missing a rig graph.",
+        phase: "registration",
+        timestamp: performance.now()
+      });
+      return;
+    }
+    const rigSpec = normalize(rigAsset.spec);
     const rigOutputs = collectOutputPaths(rigSpec);
     const rigInputs = collectInputPaths(rigSpec);
     rigInputMapRef.current = collectInputPathMap(rigSpec);
     outputPathsRef.current = new Set(rigOutputs);
     const rigConfig = {
-      id: assetBundle.rig.id,
+      id: rigAsset.id,
       spec: rigSpec,
-      subs: assetBundle.rig.subscriptions ?? {
+      subs: rigAsset.subscriptions ?? {
         inputs: rigInputs,
         outputs: rigOutputs
       }
@@ -519,7 +684,6 @@ function VizijRuntimeProviderInner({
         }
       });
     }
-    clearControllers();
     const graphIds = [];
     try {
       if (graphConfigs.length > 1) {
@@ -988,7 +1152,7 @@ function VizijRuntimeProviderInner({
 
 // src/VizijRuntimeFace.tsx
 var import_react4 = require("react");
-var import_render3 = require("@vizij/render");
+var import_render2 = require("@vizij/render");
 
 // src/hooks/useVizijRuntime.ts
 var import_react3 = require("react");
@@ -1013,7 +1177,7 @@ function VizijRuntimeFaceInner({
     return null;
   }
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-    import_render3.Vizij,
+    import_render2.Vizij,
     {
       ...props,
       rootId,
@@ -1024,11 +1188,11 @@ function VizijRuntimeFaceInner({
 var VizijRuntimeFace = (0, import_react4.memo)(VizijRuntimeFaceInner);
 
 // src/hooks/useVizijOutputs.ts
-var import_render4 = require("@vizij/render");
+var import_render3 = require("@vizij/render");
 var import_utils = require("@vizij/utils");
 function useVizijOutputs(paths) {
   const { namespace } = useVizijRuntime();
-  return (0, import_render4.useVizijStore)((state) => {
+  return (0, import_render3.useVizijStore)((state) => {
     const result = {};
     paths.forEach((path) => {
       const lookup = (0, import_utils.getLookup)(namespace, path);
@@ -1040,11 +1204,11 @@ function useVizijOutputs(paths) {
 
 // src/hooks/useRigInput.ts
 var import_react5 = require("react");
-var import_render5 = require("@vizij/render");
+var import_render4 = require("@vizij/render");
 var import_utils2 = require("@vizij/utils");
 function useRigInput(path) {
   const { namespace, setInput } = useVizijRuntime();
-  const value = (0, import_render5.useVizijStore)(
+  const value = (0, import_render4.useVizijStore)(
     (state) => state.values.get((0, import_utils2.getLookup)(namespace, path))
   );
   const setter = (0, import_react5.useCallback)(

package/dist/index.mjs

@@ -6,7 +6,12 @@ import {
   useRef,
   useState
 } from "react";
-import { VizijContext, createVizijStore } from "@vizij/render";
+import {
+  VizijContext,
+  createVizijStore,
+  loadGLTFWithBundle,
+  loadGLTFFromBlobWithBundle
+} from "@vizij/render";
 import {
   OrchestratorProvider,
   useOrchestrator,
@@ -202,7 +207,6 @@ function valueJSONToRaw(value) {
 }
 
 // src/VizijRuntimeProvider.tsx
-import { loadGLTF, loadGLTFFromBlob } from "@vizij/render";
 import { jsx } from "react/jsx-runtime";
 var DEFAULT_MERGE = {
   outputs: "add",
@@ -238,6 +242,128 @@ function normalisePath(path) {
   }
   return path.startsWith("debug/") ? path.slice("debug/".length) : path;
 }
+function normaliseBundleKind(kind) {
+  return typeof kind === "string" ? kind.toLowerCase() : "";
+}
+function pickBundleGraph(bundle, preferredKinds) {
+  if (!bundle?.graphs || bundle.graphs.length === 0) {
+    return null;
+  }
+  const preferred = preferredKinds.map((kind) => kind.toLowerCase());
+  for (const entry of bundle.graphs) {
+    if (!entry || typeof entry !== "object") {
+      continue;
+    }
+    const kind = normaliseBundleKind(entry.kind);
+    if (preferred.includes(kind)) {
+      return entry;
+    }
+  }
+  if (bundle.graphs.length === 1) {
+    return bundle.graphs[0] ?? null;
+  }
+  return null;
+}
+function convertBundleGraph(entry) {
+  if (!entry || !entry.id || !entry.spec) {
+    return null;
+  }
+  return {
+    id: entry.id,
+    spec: entry.spec
+  };
+}
+function convertBundleAnimations(entries) {
+  if (!Array.isArray(entries) || entries.length === 0) {
+    return [];
+  }
+  return entries.filter(
+    (entry) => Boolean(entry && typeof entry.id === "string" && entry.clip)
+  ).map((entry) => ({
+    id: entry.id,
+    clip: entry.clip
+  }));
+}
+function mergeAnimationLists(explicit, fromBundle) {
+  if (!explicit?.length && fromBundle.length === 0) {
+    return void 0;
+  }
+  if (!explicit?.length) {
+    return fromBundle.length > 0 ? fromBundle : void 0;
+  }
+  if (fromBundle.length === 0) {
+    return explicit;
+  }
+  const seen = new Set(explicit.map((anim) => anim.id));
+  let changed = false;
+  const merged = [...explicit];
+  for (const anim of fromBundle) {
+    if (!anim.id || seen.has(anim.id)) {
+      continue;
+    }
+    merged.push(anim);
+    seen.add(anim.id);
+    changed = true;
+  }
+  return changed ? merged : explicit;
+}
+function mergeAssetBundle(base, extracted) {
+  const resolvedBundle = base.bundle ?? extracted ?? null;
+  const rigFromBundle = convertBundleGraph(
+    pickBundleGraph(resolvedBundle, ["rig"])
+  );
+  const resolvedRig = base.rig ?? rigFromBundle ?? void 0;
+  const basePose = base.pose;
+  const poseStageFilter = basePose?.stageNeutralFilter;
+  const poseGraphFromBundle = basePose?.graph ? null : convertBundleGraph(
+    pickBundleGraph(resolvedBundle, ["pose-driver", "pose"])
+  );
+  const resolvedPoseGraph = basePose?.graph ?? poseGraphFromBundle ?? void 0;
+  const resolvedPoseConfig = basePose?.config ?? resolvedBundle?.poses?.config ?? void 0;
+  let resolvedPose = basePose;
+  if (basePose) {
+    const nextPose = { ...basePose };
+    let changed = false;
+    if (resolvedPoseGraph && basePose.graph !== resolvedPoseGraph) {
+      nextPose.graph = resolvedPoseGraph;
+      changed = true;
+    }
+    if (resolvedPoseConfig && basePose.config !== resolvedPoseConfig) {
+      nextPose.config = resolvedPoseConfig;
+      changed = true;
+    }
+    if (!resolvedPoseGraph && !basePose.graph) {
+    }
+    if (!resolvedPoseConfig && !basePose.config) {
+    }
+    resolvedPose = changed ? nextPose : basePose;
+  } else if (resolvedPoseGraph || resolvedPoseConfig || typeof poseStageFilter === "function") {
+    resolvedPose = {
+      ...resolvedPoseGraph ? { graph: resolvedPoseGraph } : {},
+      ...resolvedPoseConfig ? { config: resolvedPoseConfig } : {},
+      ...typeof poseStageFilter === "function" ? { stageNeutralFilter: poseStageFilter } : {}
+    };
+  }
+  const animationsFromBundle = convertBundleAnimations(
+    resolvedBundle?.animations
+  );
+  const resolvedAnimations = mergeAnimationLists(
+    base.animations,
+    animationsFromBundle
+  );
+  const merged = {
+    ...base
+  };
+  if (resolvedRig) {
+    merged.rig = resolvedRig;
+  } else {
+    merged.rig = void 0;
+  }
+  merged.pose = resolvedPose;
+  merged.animations = resolvedAnimations;
+  merged.bundle = resolvedBundle;
+  return merged;
+}
 function VizijRuntimeProvider({
   assetBundle,
   children,
@@ -278,7 +404,7 @@ function VizijRuntimeProvider({
   ) });
 }
 function VizijRuntimeProviderInner({
-  assetBundle,
+  assetBundle: initialAssetBundle,
   namespace: namespaceProp,
   faceId: faceIdProp,
   mergeStrategy,
@@ -288,6 +414,30 @@ function VizijRuntimeProviderInner({
   children,
   autoCreate
 }) {
+  const [extractedBundle, setExtractedBundle] = useState(() => {
+    if (initialAssetBundle.bundle) {
+      return initialAssetBundle.bundle;
+    }
+    if (initialAssetBundle.glb.kind === "world" && initialAssetBundle.glb.bundle) {
+      return initialAssetBundle.glb.bundle;
+    }
+    return null;
+  });
+  useEffect(() => {
+    if (initialAssetBundle.bundle) {
+      setExtractedBundle(initialAssetBundle.bundle);
+      return;
+    }
+    if (initialAssetBundle.glb.kind === "world") {
+      setExtractedBundle(initialAssetBundle.glb.bundle ?? null);
+    } else {
+      setExtractedBundle(null);
+    }
+  }, [initialAssetBundle]);
+  const assetBundle = useMemo(
+    () => mergeAssetBundle(initialAssetBundle, extractedBundle),
+    [initialAssetBundle, extractedBundle]
+  );
   const {
     ready,
     createOrchestrator,
@@ -407,27 +557,36 @@ function VizijRuntimeProviderInner({
       try {
         let world;
         let animatables;
+        let bundle = assetBundle.bundle ?? null;
         if (assetBundle.glb.kind === "url") {
-          [world, animatables] = await loadGLTF(
+          const loaded = await loadGLTFWithBundle(
             assetBundle.glb.src,
             [namespace],
             assetBundle.glb.aggressiveImport ?? false,
             assetBundle.glb.rootBounds
           );
+          world = loaded.world;
+          animatables = loaded.animatables;
+          bundle = loaded.bundle ?? bundle;
         } else if (assetBundle.glb.kind === "blob") {
-          [world, animatables] = await loadGLTFFromBlob(
+          const loaded = await loadGLTFFromBlobWithBundle(
             assetBundle.glb.blob,
             [namespace],
             assetBundle.glb.aggressiveImport ?? false,
             assetBundle.glb.rootBounds
           );
+          world = loaded.world;
+          animatables = loaded.animatables;
+          bundle = loaded.bundle ?? bundle;
         } else {
           world = assetBundle.glb.world;
           animatables = assetBundle.glb.animatables;
+          bundle = assetBundle.glb.bundle ?? bundle;
         }
         if (cancelled) {
           return;
         }
+        setExtractedBundle(bundle ?? null);
         const rootId = findRootId(world);
         store.getState().addWorldElements(world, animatables, true);
         reportStatus((prev) => ({
@@ -464,7 +623,8 @@ function VizijRuntimeProviderInner({
     store,
     pushError,
     reportStatus,
-    resetErrors
+    resetErrors,
+    setExtractedBundle
   ]);
   useEffect(() => {
     if (!ready && autoCreate) {
@@ -480,15 +640,25 @@ function VizijRuntimeProviderInner({
   }, [ready, autoCreate, createOrchestrator, pushError]);
   const registerControllers = useCallback(async () => {
     const normalize = (spec) => spec;
-    const rigSpec = normalize(assetBundle.rig.spec);
+    clearControllers();
+    const rigAsset = assetBundle.rig;
+    if (!rigAsset) {
+      pushError({
+        message: "Asset bundle is missing a rig graph.",
+        phase: "registration",
+        timestamp: performance.now()
+      });
+      return;
+    }
+    const rigSpec = normalize(rigAsset.spec);
     const rigOutputs = collectOutputPaths(rigSpec);
     const rigInputs = collectInputPaths(rigSpec);
     rigInputMapRef.current = collectInputPathMap(rigSpec);
     outputPathsRef.current = new Set(rigOutputs);
     const rigConfig = {
-      id: assetBundle.rig.id,
+      id: rigAsset.id,
       spec: rigSpec,
-      subs: assetBundle.rig.subscriptions ?? {
+      subs: rigAsset.subscriptions ?? {
         inputs: rigInputs,
         outputs: rigOutputs
       }
@@ -507,7 +677,6 @@ function VizijRuntimeProviderInner({
         }
       });
     }
-    clearControllers();
     const graphIds = [];
     try {
       if (graphConfigs.length > 1) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vizij/runtime-react",
   "description": "Runtime provider that bridges Vizij renderer assets with orchestrator controllers for React apps.",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",