@reactvision/react-viro 2.53.1 → 2.55.0

package/dist/plugins/withViroVisionOS.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * withViroVisionOS.ts
+ *
+ * Expo config plugin that adds a visionOS target to your app's Xcode project.
+ *
+ * What it does:
+ *   1. Writes the SwiftUI App entry point (ViroVisionApp.swift) into the target folder
+ *   2. Adds a visionOS pod target to the Podfile
+ *   3. Creates a visionOS Xcode target in the .pbxproj with correct SDK + build settings
+ *
+ * Usage in app.json:
+ *   {
+ *     "plugins": [
+ *       ["@reactvision/react-viro", { ... }],
+ *       "@reactvision/react-viro/plugins/withViroVisionOS"
+ *     ]
+ *   }
+ *
+ * After running `expo prebuild`, run `pod install` in ios/ then build the
+ * <AppName>Vision target in Xcode targeting the visionOS simulator.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withViroVisionOS = void 0;
+const config_plugins_1 = require("@expo/config-plugins");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// ─── Constants ────────────────────────────────────────────────────────────────
+const TARGET_SUFFIX = "Vision";
+const VISIONOS_DEPLOYMENT_TARGET = "1.0";
+const PODFILE_MARKER = "# viro-visionos-target";
+// ─── Swift App entry point template ──────────────────────────────────────────
+function viroVisionAppSwift(targetName, bundleId) {
+    return `// ViroVisionApp.swift
+// Auto-generated by @reactvision/react-viro — DO NOT EDIT MANUALLY.
+// Re-generated on every expo prebuild run.
+
+import SwiftUI
+import ViroReact
+
+@main
+struct ${targetName}App: App {
+    /// Current immersion style — driven by ViroVisionOSModule.enterImmersiveSpace(style).
+    @State private var immersionStyle: ImmersionStyle = .mixed
+
+    var body: some Scene {
+        // Main 2D window (hosts React Native UI if needed, or acts as launch host).
+        WindowGroup {
+            ViroVisionLaunchView()
+                .viroImmersiveSpaceController()
+        }
+
+        // The Viro immersive rendering space.
+        // Opened via ViroVisionOSModule.enterImmersiveSpace() from JavaScript.
+        ImmersiveSpace(id: ViroImmersiveSpace.id) {
+            ViroImmersiveSpaceView()
+        }
+        .immersionStyle(selection: $immersionStyle, in: .mixed, .full, .progressive)
+    }
+}
+
+/// Minimal launch view displayed in the 2D window.
+/// Replace with your own SwiftUI content or a React Native root view.
+struct ViroVisionLaunchView: View {
+    @State private var isImmersed = false
+
+    var body: some View {
+        VStack(spacing: 20) {
+            Text("ReactVision AR")
+                .font(.largeTitle)
+                .fontWeight(.bold)
+
+            Button(isImmersed ? "Exit Immersive Space" : "Enter Immersive Space") {
+                Task {
+                    if isImmersed {
+                        await ViroImmersiveCoordinator.shared.exit()
+                    } else {
+                        await ViroImmersiveCoordinator.shared.enter(styleString: "mixed")
+                    }
+                    isImmersed.toggle()
+                }
+            }
+            .buttonStyle(.borderedProminent)
+        }
+        .padding(40)
+    }
+}
+`;
+}
+// ─── 1. Write Swift files ─────────────────────────────────────────────────────
+const withVisionOSSwiftFiles = (config) => {
+    return (0, config_plugins_1.withDangerousMod)(config, [
+        "ios",
+        async (newConfig) => {
+            const root = newConfig.modRequest.platformProjectRoot;
+            const projectName = newConfig.modRequest.projectName;
+            const targetName = `${projectName}${TARGET_SUFFIX}`;
+            const bundleId = `${newConfig.ios?.bundleIdentifier ?? "com.example"}.vision`;
+            const targetDir = path_1.default.join(root, targetName);
+            if (!fs_1.default.existsSync(targetDir)) {
+                fs_1.default.mkdirSync(targetDir, { recursive: true });
+            }
+            // Always overwrite — it's auto-generated.
+            fs_1.default.writeFileSync(path_1.default.join(targetDir, "ViroVisionApp.swift"), viroVisionAppSwift(targetName, bundleId), "utf-8");
+            return newConfig;
+        },
+    ]);
+};
+// ─── 2. Podfile target block ──────────────────────────────────────────────────
+const withVisionOSPodfile = (config) => {
+    return (0, config_plugins_1.withDangerousMod)(config, [
+        "ios",
+        async (newConfig) => {
+            const root = newConfig.modRequest.platformProjectRoot;
+            const projectName = newConfig.modRequest.projectName;
+            const targetName = `${projectName}${TARGET_SUFFIX}`;
+            const podfilePath = path_1.default.join(root, "Podfile");
+            let podfile = fs_1.default.readFileSync(podfilePath, "utf-8");
+            // Idempotent — skip if already present.
+            if (podfile.includes(PODFILE_MARKER))
+                return newConfig;
+            const podBlock = [
+                "",
+                PODFILE_MARKER,
+                `# ViroKit (iOS-only) and ViroReact (ObjC) are excluded until ViroKit`,
+                `# is compiled for xros SDK (Week 2). The POC uses Metal + CompositorServices directly.`,
+                `target '${targetName}' do`,
+                `end`,
+                "",
+            ].join("\n");
+            fs_1.default.writeFileSync(podfilePath, podfile + podBlock, "utf-8");
+            return newConfig;
+        },
+    ]);
+};
+// ─── 3. Xcode target ─────────────────────────────────────────────────────────
+const withVisionOSXcodeTarget = (config) => {
+    return (0, config_plugins_1.withXcodeProject)(config, (newConfig) => {
+        const pbxProject = newConfig.modResults;
+        const projectName = newConfig.modRequest.projectName;
+        const targetName = `${projectName}${TARGET_SUFFIX}`;
+        const bundleId = `${newConfig.ios?.bundleIdentifier ?? "com.example"}.vision`;
+        const targetDir = targetName; // relative path inside ios/
+        // ── Check for existing target ────────────────────────────────────────────
+        const nativeTargets = pbxProject.pbxNativeTargetSection();
+        const alreadyExists = Object.values(nativeTargets).some((t) => t &&
+            typeof t === "object" &&
+            (t.name === targetName || t.name === `"${targetName}"`));
+        if (alreadyExists)
+            return newConfig;
+        // ── Add the target (creates PBX phases + config list) ────────────────────
+        const target = pbxProject.addTarget(targetName, "application", targetDir, bundleId);
+        if (!target) {
+            config_plugins_1.WarningAggregator.addWarningIOS("withViroVisionOS", `Failed to add visionOS target "${targetName}" to Xcode project. ` +
+                "Add it manually in Xcode: File → New → Target → visionOS → App.");
+            return newConfig;
+        }
+        // ── Set visionOS build settings on every config for this target ──────────
+        const configList = pbxProject.pbxXCBuildConfigurationSection();
+        for (const conf of Object.values(configList)) {
+            if (!conf || typeof conf !== "object" || !conf.buildSettings)
+                continue;
+            const name = conf.buildSettings.PRODUCT_NAME;
+            if (!name)
+                continue;
+            const normalized = name.replace(/^"(.*)"$/, "$1");
+            if (normalized !== targetName)
+                continue;
+            const bs = conf.buildSettings;
+            // visionOS SDK
+            bs.SDKROOT = "xros";
+            bs.SUPPORTED_PLATFORMS = '"xros xrsimulator"';
+            bs[`"DEPLOYMENT_TARGET[sdk=xros*]"`] = `"${VISIONOS_DEPLOYMENT_TARGET}"`;
+            bs.TARGETED_DEVICE_FAMILY = '"7"';
+            // Swift
+            bs.SWIFT_VERSION = '"5.0"';
+            bs.CLANG_ENABLE_MODULES = "YES";
+            // Runpath for dynamic frameworks (CocoaPods)
+            bs.LD_RUNPATH_SEARCH_PATHS = '"$(inherited) @executable_path/Frameworks"';
+            // Embed Swift standard libraries
+            bs.ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = "YES";
+            // App-specific
+            bs.PRODUCT_BUNDLE_IDENTIFIER = `"${bundleId}"`;
+            bs.INFOPLIST_FILE = `"${targetDir}/Info.plist"`;
+            bs.GENERATE_INFOPLIST_FILE = "NO";
+            bs.ASSETCATALOG_COMPILER_APPICON_NAME = "AppIcon";
+            // Don't strip Swift symbols in debug
+            if (conf.name === "Debug") {
+                bs.SWIFT_OPTIMIZATION_LEVEL = '"-Onone"';
+                bs.SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG";
+            }
+        }
+        // ── Write Info.plist for the visionOS target ──────────────────────────────
+        // (written during the dangerous mod pass — cannot write files here)
+        // Logged as a reminder.
+        config_plugins_1.WarningAggregator.addWarningIOS("withViroVisionOS", `visionOS target "${targetName}" added. ` +
+            `Run "pod install" in ios/ then build the target in Xcode. ` +
+            `An Info.plist will be auto-generated by Xcode for the new target.`);
+        return newConfig;
+    });
+};
+// ─── 4. Info.plist for visionOS target ───────────────────────────────────────
+const INFOPLIST_CONTENT = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>$(DEVELOPMENT_LANGUAGE)</string>
+    <key>CFBundleExecutable</key>
+    <string>$(EXECUTABLE_NAME)</string>
+    <key>CFBundleIdentifier</key>
+    <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleName</key>
+    <string>$(PRODUCT_NAME)</string>
+    <key>CFBundlePackageType</key>
+    <string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
+    <key>CFBundleShortVersionString</key>
+    <string>1.0</string>
+    <key>CFBundleVersion</key>
+    <string>1</string>
+    <key>UIApplicationSceneManifest</key>
+    <dict>
+        <key>UIApplicationSupportsMultipleScenes</key>
+        <true/>
+    </dict>
+    <key>NSHandsTrackingUsageDescription</key>
+    <string>Hand tracking is used for interaction in AR experiences.</string>
+</dict>
+</plist>
+`;
+const withVisionOSInfoPlist = (config) => {
+    return (0, config_plugins_1.withDangerousMod)(config, [
+        "ios",
+        async (newConfig) => {
+            const root = newConfig.modRequest.platformProjectRoot;
+            const projectName = newConfig.modRequest.projectName;
+            const targetName = `${projectName}${TARGET_SUFFIX}`;
+            const targetDir = path_1.default.join(root, targetName);
+            if (!fs_1.default.existsSync(targetDir)) {
+                fs_1.default.mkdirSync(targetDir, { recursive: true });
+            }
+            const plistPath = path_1.default.join(targetDir, "Info.plist");
+            if (!fs_1.default.existsSync(plistPath)) {
+                fs_1.default.writeFileSync(plistPath, INFOPLIST_CONTENT, "utf-8");
+            }
+            return newConfig;
+        },
+    ]);
+};
+// ─── Main export ──────────────────────────────────────────────────────────────
+const withViroVisionOS = (config) => {
+    return (0, config_plugins_1.withPlugins)(config, [
+        withVisionOSSwiftFiles,
+        withVisionOSInfoPlist,
+        withVisionOSPodfile,
+        withVisionOSXcodeTarget,
+    ]);
+};
+exports.withViroVisionOS = withViroVisionOS;
+exports.default = exports.withViroVisionOS;

package/index.ts

@@ -4,6 +4,8 @@
  *
  */
 import { ViroAnimations } from "./components/Animation/ViroAnimations";
+import { StudioSceneNavigator, StudioARScene } from "./components/Studio";
+import { ViroVisionOSModule, isVisionOS, enterImmersiveSpace, exitImmersiveSpace } from "./components/VisionOS/ViroVisionOSModule";
 import { Viro3DObject } from "./components/Viro3DObject";
 import { Viro360Image } from "./components/Viro360Image";
 import { Viro360Video } from "./components/Viro360Video";
@@ -59,14 +61,22 @@ import { ViroSpotLight } from "./components/ViroSpotLight";
 import { ViroText } from "./components/ViroText";
 import { ViroVideo } from "./components/ViroVideo";
 import { ViroVRSceneNavigator } from "./components/ViroVRSceneNavigator";
+import { ViroXRSceneNavigator } from "./components/ViroXRSceneNavigator";
 import { Viro3DSceneNavigator } from "./components/Viro3DSceneNavigator";
+import { hasOpenXRSupport, isQuest } from "./components/Utilities/ViroPlatform";
+import { useAnySourceHover } from "./components/Utilities/useAnySourceHover";
+import { useAnySourcePressed } from "./components/Utilities/useAnySourcePressed";
 import { ViroTextStyle } from "./components/Styles/ViroTextStyle";
 import { ViroStyle } from "./components/Styles/ViroStyle";
 import {
   polarToCartesian,
   polarToCartesianActual,
   isARSupportedOnDevice,
+  requestRequiredPermissions,
+  checkPermissions,
   ViroARSupportResponse,
+  ViroPermissionsResult,
+  ViroPermission,
   latLngToMercator,
   gpsToArWorld,
 } from "./components/Utilities/ViroUtils";
@@ -157,10 +167,25 @@ import {
   ViroMonocularDepthSupportResult,
   ViroMonocularDepthModelAvailableResult,
   ViroMonocularDepthPreferenceResult,
+  // Quest / OpenXR Hand Tracking Types
+  ViroJoint,
+  ViroHandJoints,
+  ViroHandPinchEvent,
+  ViroHandUpdateEvent,
 } from "./components/Types/ViroEvents";
 import { ViroSurface } from "./components/ViroSurface";
 import { ViroSceneNavigator } from "./components/ViroSceneNavigator";
 import { VIRO_VERSION } from "./components/Utilities/ViroVersion";
+import { ViroQuestEntryPoint } from "./components/ViroQuestEntryPoint";
+import { VRQuestNavigatorBridge } from "./components/Utilities/VRQuestNavigatorBridge";
+import { VRModuleOpenXR, useVRViewTag, exitVRScene } from "./components/Utilities/VRModuleOpenXR";
+import type { VRModuleOpenXRType } from "./components/Utilities/VRModuleOpenXR";
+import { AppRegistry } from "react-native";
+
+// Auto-register the Quest VR entry point. VRActivity launches this component
+// as 'VRQuestScene'. Registering here means apps need no manual setup.
+// Apps that need a custom VR root can re-register after importing this package.
+AppRegistry.registerComponent("VRQuestScene", () => ViroQuestEntryPoint);
 
 export {
   ViroARImageMarker,
@@ -211,18 +236,33 @@ export {
   ViroText,
   ViroVideo,
   ViroVRSceneNavigator,
+  ViroXRSceneNavigator,
+  ViroQuestEntryPoint,
+  // Quest bridge — for custom VR roots and VRModuleOpenXR viewTag access
+  VRQuestNavigatorBridge,
+  VRModuleOpenXR,
+  useVRViewTag,
+  exitVRScene,
   Viro3DSceneNavigator,
   // Utilities
+  hasOpenXRSupport,
+  isQuest,
+  useAnySourceHover,
+  useAnySourcePressed,
   ViroARTrackingReasonConstants,
   ViroRecordingErrorConstants,
   ViroTrackingStateConstants,
   polarToCartesian,
   polarToCartesianActual,
   isARSupportedOnDevice,
+  requestRequiredPermissions,
+  checkPermissions,
   latLngToMercator,
   gpsToArWorld,
   // Types
   ViroARSupportResponse,
+  ViroPermissionsResult,
+  ViroPermission,
   ViroHoverEvent,
   ViroClickEvent,
   ViroClickStateEvent,
@@ -315,4 +355,30 @@ export {
   ViroMonocularDepthSupportResult,
   ViroMonocularDepthModelAvailableResult,
   ViroMonocularDepthPreferenceResult,
+  // Quest / OpenXR Hand Tracking Types
+  ViroJoint,
+  ViroHandJoints,
+  ViroHandPinchEvent,
+  ViroHandUpdateEvent,
+  // Studio Integration
+  StudioSceneNavigator,
+  StudioARScene,
+  // VisionOS
+  ViroVisionOSModule,
+  isVisionOS,
+  enterImmersiveSpace,
+  exitImmersiveSpace,
 };
+
+export type { VRModuleOpenXRType };
+export type { ImmersiveSpaceStyle } from "./components/VisionOS/ViroVisionOSModule";
+
+export type {
+  StudioSceneResponse,
+  StudioAsset,
+  StudioAnimation,
+  StudioCollisionBinding,
+  StudioSceneFunction,
+  StudioSceneMeta,
+  StudioProjectMeta,
+} from "./components/Studio";

package/ios/ViroReact.podspec

@@ -12,10 +12,14 @@ Pod::Spec.new do |s|
   s.author              = 'ReactVision'
   s.requires_arc        = true
   s.platform            = :ios, '12.0'
-  s.ios.deployment_target = '12.0'
-  
+  s.ios.deployment_target     = '12.0'
+  s.visionos.deployment_target = '1.0'
+
+  # visionOS: CompositorServices drives the immersive render loop.
+  s.visionos.frameworks = ['Metal', 'MetalKit', 'CompositorServices', 'ARKit']
+
   # Base source files (always included)
-  source_files_array = ['ViroReact/**/*.{h,m,mm}']
+  source_files_array = ['ViroReact/**/*.{h,m,mm,swift}']
   header_files_array = ['ViroReact/**/*.h']
   
   # Include dist files if they exist (for release builds)
@@ -26,7 +30,12 @@ Pod::Spec.new do |s|
   
   s.source_files        = source_files_array
   s.public_header_files = header_files_array
-  
+
+  # visionOS-only sources: keep them out of the iOS build so consumers running
+  # `pod install` for iOS don't pull CompositorServices / VRODriverVisionOS.h
+  # into a target where those symbols don't exist.
+  s.ios.exclude_files = ['ViroReact/VisionOS/**/*']
+
   if File.exist?(File.join(__dir__, 'dist/lib/libViroReact.a'))
     s.vendored_libraries = 'dist/lib/libViroReact.a'
   end
@@ -40,7 +49,8 @@ Pod::Spec.new do |s|
   s.dependency 'React-FabricComponents'
   
   # Fabric-specific build configuration
-  s.pod_target_xcconfig = { 
+  s.pod_target_xcconfig = {
+    'SWIFT_VERSION' => '5.0',
     'CLANG_CXX_LANGUAGE_STANDARD' => 'c++17',
     'HEADER_SEARCH_PATHS' => [
       '"$(PODS_TARGET_SRCROOT)/ViroReact"',

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROARSession.h

@@ -319,7 +319,21 @@ public:
      texture are updated after each call to updateFrame().
      */
     virtual std::shared_ptr<VROTexture> getCameraBackgroundTexture() = 0;
-    
+
+    /*
+     Get the semantic texture for the current frame. Each pixel is a VROSemanticLabel
+     value (0-11, R8 format). Returns nullptr if semantic mode is not enabled or
+     the platform does not support it.
+     */
+    virtual std::shared_ptr<VROTexture> getSemanticTexture() { return nullptr; }
+
+    /*
+     Get the confidence texture for the current frame. Each pixel is a confidence value
+     (R8, 0=uncertain, 255=certain) corresponding to the label in getSemanticTexture().
+     Returns nullptr if not supported; callers should substitute a 1×1 white texture.
+     */
+    virtual std::shared_ptr<VROTexture> getSemanticConfidenceTexture() { return nullptr; }
+
     /*
      Invoke when the viewport changes. The AR engine may adjust its camera
      background and projection matrices in response to a viewport change.
@@ -557,6 +571,21 @@ public:
         std::function<void(bool success, std::string error)> callback) {
         if (callback) callback(false, "Not supported");
     }
+    virtual void rvGetScene(
+        const std::string& sceneId,
+        std::function<void(bool success, std::string jsonData, std::string error)> callback) {
+        if (callback) callback(false, "", "Not supported");
+    }
+    virtual void rvGetSceneAssets(
+        const std::string& sceneId,
+        std::function<void(bool success, std::string jsonData, std::string error)> callback) {
+        if (callback) callback(false, "", "Not supported");
+    }
+    virtual void rvGetProject(
+        const std::string& projectId,
+        std::function<void(bool success, std::string jsonData, std::string error)> callback) {
+        if (callback) callback(false, "", "Not supported");
+    }
 
     // ========================================================================
     // ReactVision Geospatial CRUD API

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROARSessioniOS.h

@@ -90,6 +90,8 @@ public:
     std::unique_ptr<VROARFrame> &updateFrame();
     std::unique_ptr<VROARFrame> &getLastFrame();
     std::shared_ptr<VROTexture> getCameraBackgroundTexture();
+    std::shared_ptr<VROTexture> getSemanticTexture() override;
+    std::shared_ptr<VROTexture> getSemanticConfidenceTexture() override;
     
     void setViewport(VROViewport viewport);
     void setOrientation(VROCameraOrientation orientation);
@@ -195,6 +197,12 @@ public:
         double confidence, int matchCount, int inlierCount, int processingTimeMs,
         const std::string& platform, const std::string& externalUserId,
         std::function<void(bool, std::string)> callback) override;
+    void rvGetProject(const std::string& projectId,
+        std::function<void(bool, std::string, std::string)> callback) override;
+    void rvGetScene(const std::string& sceneId,
+        std::function<void(bool, std::string, std::string)> callback) override;
+    void rvGetSceneAssets(const std::string& sceneId,
+        std::function<void(bool, std::string, std::string)> callback) override;
 
     // Scene Semantics API
     bool isSemanticModeSupported() const override;
@@ -326,6 +334,14 @@ private:
      Video texture cache used for transferring camera content to OpenGL.
      */
     std::shared_ptr<VROVideoTextureCacheOpenGL> _videoTextureCache;
+
+    /*
+     Fallback 1×1 all-white confidence texture (conf=1.0 everywhere).
+     Returned by getSemanticConfidenceTexture() because the ARCore iOS SDK does not
+     expose a per-pixel confidence image. The result is hard alpha edges (no soft blend)
+     on iOS, identical to the previous discard behaviour.
+     */
+    std::shared_ptr<VROTexture> _defaultConfidenceTexture;
     
     /*
      Update the VROARAnchor with the transforms in the given ARAnchor.

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROGLTFLoader.h

@@ -37,6 +37,8 @@
 #include "VROMaterial.h"
 #include "VROModelIOUtil.h"
 #include "VROByteBuffer.h"
+#include "VROVector3f.h"
+#include "VROQuaternion.h"
 
 class VROMorpher;
 class VRONode;
@@ -143,6 +145,7 @@ private:
                                     std::map<int, std::shared_ptr<VROMorpher>> &morphers,
                                     std::shared_ptr<VRODriver> driver);
     static std::string getMorphTargetName(const tinygltf::Model &gModel,
+                                          const tinygltf::Mesh &gMesh,
                                           const tinygltf::Primitive &gPrimtive, int targetIndex);
 
     static void injectGLTF(std::shared_ptr<VRONode> gltfNode, std::shared_ptr<VRONode> rootNode,
@@ -213,6 +216,7 @@ private:
                                               const tinygltf::Skin &skin,
                                               std::vector<VROMatrix4f> &invBindTransformsOut);
     static void clearCachedData();
+    static void injectBindPoseAnimations();
 
     /*
      As multiple mesh attributes may point to the same texture or data arrays when loading a
@@ -240,6 +244,24 @@ private:
     static std::map<int, std::shared_ptr<VROGeometrySource>> _meshBoneIndices;
     static std::map<int, std::shared_ptr<VROGeometrySource>> _meshBoneWeights;
 
+    /*
+     Maps each glTF node index to its parent node index. Needed to walk up the scene graph
+     for multi-skin models where a skin's root joint has non-joint ancestors (e.g. a visor
+     skin whose root is the Neck joint, whose ancestors Hips/Spine are only in the body skin).
+     Populated in processSkinner(), cleared in clearCachedData().
+     */
+    static std::map<int, int> _nodeParentMap;
+
+    /*
+     Maps each skin index to the set of node indices that are ancestors of that skin's mesh
+     node (the glTF node that has gNode.skin == skinIndex). These ancestors are already applied
+     by Viro's renderer as the mesh node's modelMatrix, so the ancestor walk in
+     processSkeletalTransformsForFrame must stop before including them to avoid double-applying
+     transforms (e.g. Character's scale=0.01 being applied twice → model becomes invisible).
+     Populated in processSkinner(), cleared in clearCachedData().
+     */
+    static std::map<int, std::set<int>> _skinMeshAncestors;
+
     /*
      Cached maps of nodeIndexes to it's corresponding animations. These caches are cleared
      out after the parsing of a single gLTF model. Note that _nodeKeyFrameAnims is of the form:
@@ -248,6 +270,18 @@ private:
     static std::map<int, std::map<int, std::vector<std::shared_ptr<VROKeyframeAnimation>>>> _nodeKeyFrameAnims;
     static std::map<int, std::vector<std::shared_ptr<VROSkeletalAnimation>>> _skinSkeletalAnims;
 
+    /*
+     Per-node VRONode references and bind-pose TRS, populated during processNode for any node
+     that has keyframe animations. Used by injectBindPoseAnimations() to create single-frame
+     bind-pose reset animations for animation names a node doesn't participate in.
+     Without these, switching animations leaves non-driven nodes at the previous animation's
+     final pose, causing visible mesh disassembly.
+     */
+    static std::map<int, std::shared_ptr<VRONode>> _nodeGLTFMap;
+    static std::map<int, VROVector3f>   _nodeBindPos;
+    static std::map<int, VROVector3f>   _nodeBindScale;
+    static std::map<int, VROQuaternion> _nodeBindRot;
+
     /*
      Returns the local transform of the node index retried from the gltf model.
      */