react-three-game 0.0.71 → 0.0.73

package/dist/index.d.ts

@@ -19,16 +19,15 @@ export type { ExportGLBOptions } from './tools/prefabeditor/utils';
 export { createModelNode, createImageNode, } from './tools/prefabeditor/prefab';
 export type { PrefabEditorProps, PrefabEditorRef, } from './tools/prefabeditor/PrefabEditor';
 export type { SpawnOptions, Scene, Entity, EntityComponent, EntityData, EntityUpdate, PropertyPath, SceneUpdates, } from './tools/prefabeditor/scene';
-export type { PrefabRootProps, PrefabRootRef, SceneRuntime } from './tools/prefabeditor/PrefabRoot';
-export { useSceneRuntime } from './tools/prefabeditor/PrefabRoot';
+export type { PrefabRootProps } from './tools/prefabeditor/PrefabRoot';
+export type { AssetRuntime, EntityRuntime, LiveObjectRef, LiveRigidBodyRef } from './tools/prefabeditor/runtimeContext';
+export { useAssetRuntime, useEntityRuntime, useEntityObjectRef, useEntityRigidBodyRef } from './tools/prefabeditor/runtimeContext';
 export type { Component, ComponentViewProps } from './tools/prefabeditor/components/ComponentRegistry';
 export type { FieldDefinition, FieldType } from './tools/prefabeditor/components/Input';
 export type { Prefab, GameObject, ComponentData } from './tools/prefabeditor/types';
 export { findComponent, findComponentEntry, hasComponent } from './tools/prefabeditor/types';
 export { gameEvents, useGameEvent, getEntityIdFromRigidBody } from './tools/prefabeditor/GameEvents';
 export type { GameEventType, GameEventMap, GameEventPayload, PhysicsEventType, InteractionEventType, PhysicsEventPayload, ClickEventPayload } from './tools/prefabeditor/GameEvents';
-export { createRefBridge } from './tools/prefabeditor/RefBridge';
-export type { RefBridge } from './tools/prefabeditor/RefBridge';
 export { loadFiles } from './tools/dragdrop/DragDropLoader';
 export type { AssetLoadOptions } from './tools/dragdrop/DragDropLoader';
 export { loadModel, loadSound, loadTexture } from './tools/dragdrop/modelLoader';

package/dist/index.js

@@ -19,12 +19,10 @@ export { FieldRenderer, FieldGroup, ListEditor, Label, Vector3Input, Vector3Fiel
 // Prefab Editor - Utils
 export { loadJson, saveJson, exportGLB, exportGLBData, regenerateIds, computeParentWorldMatrix, } from './tools/prefabeditor/utils';
 export { createModelNode, createImageNode, } from './tools/prefabeditor/prefab';
-export { useSceneRuntime } from './tools/prefabeditor/PrefabRoot';
+export { useAssetRuntime, useEntityRuntime, useEntityObjectRef, useEntityRigidBodyRef } from './tools/prefabeditor/runtimeContext';
 export { findComponent, findComponentEntry, hasComponent } from './tools/prefabeditor/types';
 // Game Events (physics + custom events)
 export { gameEvents, useGameEvent, getEntityIdFromRigidBody } from './tools/prefabeditor/GameEvents';
-// RefBridge & Systems
-export { createRefBridge } from './tools/prefabeditor/RefBridge';
 // Asset Loading
 export { loadFiles } from './tools/dragdrop/DragDropLoader';
 export { loadModel, loadSound, loadTexture } from './tools/dragdrop/modelLoader';

package/dist/tools/assetviewer/page.js

@@ -4,7 +4,7 @@ import { OrbitControls, View, PerspectiveCamera } from "@react-three/drei";
 import { Component as ReactComponent, Suspense, useEffect, useLayoutEffect, useState, useRef } from "react";
 import { createPortal } from 'react-dom';
 import { TextureLoader } from "three";
-import { loadModel } from "../dragdrop";
+import { loadModel } from "../dragdrop/modelLoader";
 class ErrorBoundary extends ReactComponent {
     constructor(props) {
         super(props);

package/dist/tools/prefabeditor/PrefabEditor.d.ts

@@ -1,7 +1,6 @@
 import GameCanvas from "../../shared/GameCanvas";
 import { Object3D, Texture } from "three";
 import { GameObject, Prefab } from "./types";
-import { PrefabRootRef } from "./PrefabRoot";
 import type { ExportGLBOptions } from "./utils";
 import { type Scene, type SpawnOptions } from "./scene";
 export interface PrefabEditorRef {
@@ -17,7 +16,6 @@ export interface PrefabEditorRef {
     }) => void;
     addModel: (path: string, model: Object3D, options?: SpawnOptions) => GameObject;
     addTexture: (path: string, texture: Texture, options?: SpawnOptions) => GameObject;
-    viewRef: React.RefObject<PrefabRootRef | null>;
 }
 export declare enum PrefabEditorMode {
     Edit = "edit",

package/dist/tools/prefabeditor/PrefabEditor.js

@@ -61,6 +61,8 @@ const PrefabEditor = forwardRef(({ basePath, initialPrefab, physics = true, mode
     const onChangeRef = useRef(onChange);
     const isEditMode = mode === PrefabEditorMode.Edit;
     const getPrefab = useCallback(() => denormalizePrefab(prefabStore.getState()), [prefabStore]);
+    const getObject = useCallback((nodeId) => { var _a, _b; return (_b = (_a = prefabRootRef.current) === null || _a === void 0 ? void 0 : _a.getObject(nodeId)) !== null && _b !== void 0 ? _b : null; }, []);
+    const getRigidBody = useCallback((nodeId) => { var _a, _b; return (_b = (_a = prefabRootRef.current) === null || _a === void 0 ? void 0 : _a.getRigidBody(nodeId)) !== null && _b !== void 0 ? _b : null; }, []);
     onChangeRef.current = onChange;
     const setSelection = useCallback((nodeId) => {
         const nextNode = nodeId ? prefabStore.getState().nodesById[nodeId] : null;
@@ -157,13 +159,12 @@ const PrefabEditor = forwardRef(({ basePath, initialPrefab, physics = true, mode
         return () => unsubscribe();
     }, [prefabStore, selectedId]);
     useEffect(() => {
-        var _a, _b;
         if (!selectedId) {
             setSelectedObject(null);
             return;
         }
-        setSelectedObject((_b = (_a = prefabRootRef.current) === null || _a === void 0 ? void 0 : _a.getObject(selectedId)) !== null && _b !== void 0 ? _b : null);
-    }, [selectedId]);
+        setSelectedObject(getObject(selectedId));
+    }, [getObject, selectedId]);
     const addNode = useCallback((node, options) => {
         var _a;
         const { addChild, rootId } = prefabStore.getState();
@@ -256,39 +257,29 @@ const PrefabEditor = forwardRef(({ basePath, initialPrefab, physics = true, mode
         return exportGLBData(rootObject);
     }), [clearSelection]);
     const handleFocusNode = useCallback((nodeId) => {
-        var _a;
-        const object = (_a = prefabRootRef.current) === null || _a === void 0 ? void 0 : _a.getObject(nodeId);
+        const object = getObject(nodeId);
         const controls = controlsRef.current;
         const camera = controls === null || controls === void 0 ? void 0 : controls.object;
         if (!object || !controls || !camera)
             return;
         focusCameraOnObject(object, camera, controls.target, () => { var _a; return (_a = controls.update) === null || _a === void 0 ? void 0 : _a.call(controls); });
-    }, []);
+    }, [getObject]);
     const scene = useMemo(() => createScene({
         getRootId: () => prefabStore.getState().rootId,
         getNode: (id) => { var _a; return (_a = prefabStore.getState().nodesById[id]) !== null && _a !== void 0 ? _a : null; },
         getChildIds: (id) => { var _a; return (_a = prefabStore.getState().childIdsById[id]) !== null && _a !== void 0 ? _a : []; },
         getParentId: (id) => { var _a; return (_a = prefabStore.getState().parentIdById[id]) !== null && _a !== void 0 ? _a : null; },
-        findByName: (name) => {
-            var _a;
-            const state = prefabStore.getState();
-            const normalized = name.toLowerCase();
-            for (const [id, node] of Object.entries(state.nodesById)) {
-                if (((_a = node.name) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === normalized)
-                    return id;
-            }
-            return null;
-        },
         updateNode: (id, update) => prefabStore.getState().updateNode(id, update),
         updateNodes: (updates) => prefabStore.getState().updateNodes(Object.entries(updates).map(([id, update]) => ({ id, update }))),
         addNode: (node, options) => addNode(node, options).id,
         removeNode: (id) => prefabStore.getState().deleteNode(id),
-    }), [addNode, prefabStore]);
+        getObject,
+        getRigidBody,
+    }), [addNode, getObject, getRigidBody, prefabStore]);
     const handleTransformChange = () => {
-        var _a;
         if (!selectedId)
             return;
-        const object = (_a = prefabRootRef.current) === null || _a === void 0 ? void 0 : _a.getObject(selectedId);
+        const object = getObject(selectedId);
         if (!object)
             return;
         const parentWorld = computeParentWorldMatrix(prefabStore.getState(), selectedId);
@@ -349,10 +340,9 @@ const PrefabEditor = forwardRef(({ basePath, initialPrefab, physics = true, mode
         scene,
         load: loadPrefab,
         addModel,
-        addTexture,
-        viewRef: prefabRootRef
+        addTexture
     }), [addModel, addTexture, clearSelection, getPrefab, handleExportGLB, handleExportGLBData, handleScreenshot, loadPrefab, scene]);
-    const content = (_jsxs(_Fragment, { children: [_jsx("gridHelper", { args: [10, 10], position: [0, -1, 0] }), _jsx(PrefabRoot, { ref: prefabRootRef, store: prefabStore, editMode: isEditMode, selectedId: selectedId, onSelect: setSelection, basePath: basePath }), children] }));
+    const content = (_jsxs(_Fragment, { children: [isEditMode ? _jsx("gridHelper", { args: [10, 10], position: [0, -1, 0] }) : null, _jsx(PrefabRoot, { ref: prefabRootRef, store: prefabStore, editMode: isEditMode, selectedId: selectedId, onSelect: setSelection, basePath: basePath }), children] }));
     return _jsx(PrefabStoreProvider, { store: prefabStore, children: _jsxs(EditorContext.Provider, { value: {
                 mode,
                 setMode: updateMode,

package/dist/tools/prefabeditor/PrefabRoot.d.ts

@@ -3,29 +3,8 @@ import { ThreeEvent } from "@react-three/fiber";
 import { GameObject as GameObjectType, Prefab } from "./types";
 import { LoadedModels } from "../dragdrop";
 import { PrefabStoreApi } from "./prefabStore";
-import { type RefBridge } from "./RefBridge";
-/** Runtime context available to all component Views inside a PrefabRoot. */
-export interface SceneRuntime {
-    refBridge: RefBridge;
-    getRigidBody: (id: string) => any;
-    /** @internal Used by PhysicsComponent. */
-    registerRigidBodyRef: (id: string, rb: any) => void;
-    editMode?: boolean;
-    /** Get a loaded model by asset path. */
-    getModel: (path: string) => Object3D | null;
-    /** Get a loaded texture by asset path. */
-    getTexture: (path: string) => Texture | null;
-    /** Get a loaded sound buffer by asset path. */
-    getSound: (path: string) => AudioBuffer | null;
-    /** Get a revision string that changes when loaded assets change (for cache-busting keys). */
-    getAssetRevision: () => string;
-}
-/** Access the scene runtime (refBridge, getRigidBody, editMode) from within a component View. */
-export declare function useSceneRuntime(): SceneRuntime;
 export interface PrefabRootRef {
     root: Group | null;
-    refBridge: RefBridge;
-    rigidBodyRefs: Map<string, any>;
     getObject: (nodeId: string) => Object3D | null;
     getRigidBody: (nodeId: string) => any;
     addModel: (path: string, model: Object3D) => void;

package/dist/tools/prefabeditor/PrefabRoot.js

@@ -11,34 +11,26 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useHelper } from "@react-three/drei";
-import { forwardRef, createContext, useCallback, useContext, useEffect, useImperativeHandle, useMemo, useRef, useState } from "react";
+import { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useRef, useState } from "react";
 import { BoxHelper, Euler, Matrix4, } from "three";
 import { useStore } from "zustand";
 import { useClickValid } from "./useClickValid";
 import { findComponent } from "./types";
 import { getComponentDef, getComponentAssetRefs, registerComponent } from "./components/ComponentRegistry";
-import components from "./components";
+import { builtinComponents } from "./components";
 import { loadModel, loadSound, loadTexture } from "../dragdrop";
 import { GameInstance, GameInstanceProvider, getRepeatAxesFromModelProperties, useInstanceCheck } from "./InstanceProvider";
 import { composeTransform, decompose } from "./utils";
 import { isPhysicsProps } from "./components/PhysicsComponent";
 import { denormalizePrefab } from "./prefab";
 import { createPrefabStore, PrefabStoreProvider, useOptionalPrefabStoreApi, usePrefabChildIds, usePrefabNode, usePrefabRootId } from "./prefabStore";
-import { createRefBridge } from "./RefBridge";
+import { AssetRuntimeContext, EntityRuntimeScope } from "./runtimeContext";
 import { sound as soundManager } from "../../helpers/SoundManager";
-components.forEach(registerComponent);
+builtinComponents.forEach(registerComponent);
 const IDENTITY = new Matrix4();
 const EMPTY_MODELS = {};
 const EMPTY_TEXTURES = {};
 const EMPTY_SOUNDS = {};
-const SceneRuntimeContext = createContext(null);
-/** Access the scene runtime (refBridge, getRigidBody, editMode) from within a component View. */
-export function useSceneRuntime() {
-    const ctx = useContext(SceneRuntimeContext);
-    if (!ctx)
-        throw new Error("useSceneRuntime must be used inside <PrefabRoot>");
-    return ctx;
-}
 /** Resolve a relative or absolute asset file path against a base path. */
 function resolveAssetPath(basePath, file) {
     if (file.startsWith("http://") || file.startsWith("https://"))
@@ -68,7 +60,6 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
     const objectRefs = useRef({});
     const rigidBodyRefs = useRef(new Map());
     const rootRef = useRef(null);
-    const [refBridge] = useState(() => createRefBridge());
     const parentStore = useOptionalPrefabStoreApi();
     const [ownedStore] = useState(() => { var _a, _b; return createPrefabStore(data !== null && data !== void 0 ? data : denormalizePrefab((_b = (_a = store === null || store === void 0 ? void 0 : store.getState()) !== null && _a !== void 0 ? _a : parentStore === null || parentStore === void 0 ? void 0 : parentStore.getState()) !== null && _b !== void 0 ? _b : missingStoreState())); });
     const resolvedStore = (_a = store !== null && store !== void 0 ? store : parentStore) !== null && _a !== void 0 ? _a : ownedStore;
@@ -78,11 +69,13 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
     const availableModels = useMemo(() => (Object.assign(Object.assign({}, models), injectedModels)), [models, injectedModels]);
     const availableTextures = useMemo(() => (Object.assign(Object.assign({}, textures), injectedTextures)), [textures, injectedTextures]);
     const availableSounds = useMemo(() => (Object.assign(Object.assign({}, sounds), injectedSounds)), [sounds, injectedSounds]);
+    const getObject = useCallback((id) => {
+        var _a;
+        return (_a = objectRefs.current[id]) !== null && _a !== void 0 ? _a : null;
+    }, []);
     useImperativeHandle(ref, () => ({
         root: rootRef.current,
-        refBridge,
-        rigidBodyRefs: rigidBodyRefs.current,
-        getObject: (nodeId) => { var _a; return (_a = objectRefs.current[nodeId]) !== null && _a !== void 0 ? _a : null; },
+        getObject,
         getRigidBody: (nodeId) => { var _a; return (_a = rigidBodyRefs.current.get(nodeId)) !== null && _a !== void 0 ? _a : null; },
         addModel: (path, model) => setInjectedModels(prev => (Object.assign(Object.assign({}, prev), { [path]: model }))),
         addTexture: (path, texture) => setInjectedTextures(prev => (Object.assign(Object.assign({}, prev), { [path]: texture }))),
@@ -90,11 +83,10 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
             soundManager.setBuffer(path, sound);
             setInjectedSounds(prev => (Object.assign(Object.assign({}, prev), { [path]: sound })));
         },
-    }), [refBridge]);
+    }), [getObject]);
     const registerRef = useCallback((id, obj) => {
         objectRefs.current[id] = obj;
-        refBridge.register(id, obj);
-    }, [refBridge]);
+    }, []);
     const registerRigidBodyRef = useCallback((id, rb) => {
         rigidBodyRefs.current.set(id, rb);
     }, []);
@@ -180,11 +172,10 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
     availableTexturesRef.current = availableTextures;
     const availableSoundsRef = useRef(availableSounds);
     availableSoundsRef.current = availableSounds;
-    const sceneRuntime = useMemo(() => ({
-        refBridge,
+    const assetRuntime = useMemo(() => ({
+        getObject,
         getRigidBody,
         registerRigidBodyRef,
-        editMode,
         getModel: (path) => { var _a; return (_a = availableModelsRef.current[path]) !== null && _a !== void 0 ? _a : null; },
         getTexture: (path) => { var _a; return (_a = availableTexturesRef.current[path]) !== null && _a !== void 0 ? _a : null; },
         getSound: (path) => { var _a; return (_a = availableSoundsRef.current[path]) !== null && _a !== void 0 ? _a : null; },
@@ -193,12 +184,12 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
             const textureKeys = Object.keys(availableTexturesRef.current).sort().join('|');
             return `${textureKeys}::${modelKeys}`;
         },
-    }), [refBridge, getRigidBody, registerRigidBodyRef, editMode]);
+    }), [getObject, getRigidBody, registerRigidBodyRef]);
     const content = (_jsx("group", { ref: rootRef, children: _jsx(GameInstanceProvider, { models: availableModels, selectedId: selectedId, editMode: editMode, onSelect: editMode ? onSelect : undefined, registerRef: registerRef, children: _jsx(StoreRootNode, { selectedId: selectedId, onSelect: editMode ? onSelect : undefined, onClick: onClick, registerRef: registerRef, loadedModels: availableModels, editMode: editMode, parentMatrix: IDENTITY }) }) }));
     if (!shouldProvideStoreContext) {
-        return _jsx(SceneRuntimeContext.Provider, { value: sceneRuntime, children: content });
+        return _jsx(AssetRuntimeContext.Provider, { value: assetRuntime, children: content });
     }
-    return _jsx(PrefabStoreProvider, { store: resolvedStore, children: _jsx(SceneRuntimeContext.Provider, { value: sceneRuntime, children: content }) });
+    return _jsx(PrefabStoreProvider, { store: resolvedStore, children: _jsx(AssetRuntimeContext.Provider, { value: assetRuntime, children: content }) });
 });
 function StoreRootNode(props) {
     const rootId = usePrefabRootId();
@@ -289,14 +280,8 @@ function StandardNode({ nodeId, selectedId, onSelect, onClick, registerRef, load
     const childNodes = getChildHostComponents(gameObject).length > 0
         ? _jsx(CompositionChildren, { childIds: childIds, selectedId: selectedId, ctx: renderCtx, parentMatrix: world })
         : _jsx(ChildNodes, { childIds: childIds, parentMatrix: world, selectedId: selectedId, onSelect: onSelect, onClick: onClick, registerRef: registerRef, loadedModels: loadedModels, editMode: editMode });
-    const inner = (_jsx("group", Object.assign({}, clickHandlers, { children: renderCompositionNode(gameObject, renderCtx, isSelected, parentMatrix, childNodes) })));
-    if (editMode) {
-        return (_jsxs(_Fragment, { children: [_jsx("group", { ref: groupRef, position: transform.position, rotation: transform.rotation, scale: transform.scale, children: _jsx("mesh", { visible: false, children: _jsx("boxGeometry", { args: [0.01, 0.01, 0.01] }) }) }), _jsx("group", { ref: helperRef, position: transform.position, rotation: transform.rotation, scale: transform.scale, children: inner }), hasPhysics && (physicsDef === null || physicsDef === void 0 ? void 0 : physicsDef.View) ? (_jsx(physicsDef.View, { properties: physics.properties, position: transform.position, rotation: transform.rotation, scale: transform.scale, editMode: editMode, nodeId: nodeId, children: inner }, physicsKey)) : null] }));
-    }
-    if (hasPhysics && (physicsDef === null || physicsDef === void 0 ? void 0 : physicsDef.View)) {
-        return (_jsx(physicsDef.View, { properties: physics.properties, position: transform.position, rotation: transform.rotation, scale: transform.scale, editMode: editMode, nodeId: nodeId, children: inner }, physicsKey));
-    }
-    return (_jsx("group", { ref: groupRef, position: transform.position, rotation: transform.rotation, scale: transform.scale, children: inner }));
+    const inner = (_jsx("group", Object.assign({}, clickHandlers, { children: renderCompositionNode(gameObject, renderCtx, childNodes) })));
+    return (_jsx(EntityRuntimeScope, { nodeId: nodeId, editMode: editMode, isSelected: isSelected, children: editMode ? (_jsxs(_Fragment, { children: [_jsx("group", { ref: groupRef, position: transform.position, rotation: transform.rotation, scale: transform.scale, children: _jsx("mesh", { visible: false, children: _jsx("boxGeometry", { args: [0.01, 0.01, 0.01] }) }) }), _jsx("group", { ref: helperRef, position: transform.position, rotation: transform.rotation, scale: transform.scale, children: inner }), hasPhysics && (physicsDef === null || physicsDef === void 0 ? void 0 : physicsDef.View) ? (_jsx(physicsDef.View, { properties: physics.properties, position: transform.position, rotation: transform.rotation, scale: transform.scale, children: inner }, physicsKey)) : null] })) : hasPhysics && (physicsDef === null || physicsDef === void 0 ? void 0 : physicsDef.View) ? (_jsx(physicsDef.View, { properties: physics.properties, position: transform.position, rotation: transform.rotation, scale: transform.scale, children: inner }, physicsKey)) : (_jsx("group", { ref: groupRef, position: transform.position, rotation: transform.rotation, scale: transform.scale, children: inner })) }));
 }
 function getChildHostComponents(gameObject) {
     var _a;
@@ -385,7 +370,7 @@ function renderCompositionSubtree(gameObject, ctx, isSelected, childIds, parentM
     const transform = getNodeTransformProps(gameObject);
     const world = parentMatrix.clone().multiply(compose(gameObject));
     const childNodes = _jsx(CompositionChildren, { childIds: childIds, ctx: ctx, parentMatrix: world });
-    return (_jsx("group", { position: transform.position, rotation: transform.rotation, scale: transform.scale, children: renderCompositionNode(gameObject, ctx, isSelected, parentMatrix, childNodes) }, gameObject.id));
+    return (_jsx(EntityRuntimeScope, { nodeId: gameObject.id, editMode: ctx.editMode, isSelected: isSelected, children: _jsx("group", { position: transform.position, rotation: transform.rotation, scale: transform.scale, children: renderCompositionNode(gameObject, ctx, childNodes) }, gameObject.id) }));
 }
 function CompositionChildren({ childIds, selectedId, ctx, parentMatrix, }) {
     return childIds.map(childId => (_jsx(CompositionSubtree, { nodeId: childId, selectedId: selectedId, ctx: ctx, parentMatrix: parentMatrix }, childId)));
@@ -398,31 +383,22 @@ function CompositionSubtree({ nodeId, selectedId, ctx, parentMatrix, }) {
         return null;
     return renderCompositionSubtree(gameObject, ctx, isSelected, childIds, parentMatrix);
 }
-function renderCompositionNode(gameObject, ctx, isSelected, parentMatrix, childNodes) {
-    const ownContent = renderNodeOwnContent(gameObject, ctx, isSelected, parentMatrix);
-    return wrapWithChildHosts(gameObject, ctx, isSelected, parentMatrix, _jsxs(_Fragment, { children: [ownContent, childNodes] }));
-}
-function buildContextProps(gameObject, _ctx, isSelected) {
-    return {
-        editMode: _ctx.editMode,
-        isSelected,
-        nodeId: gameObject.id,
-    };
+function renderCompositionNode(gameObject, ctx, childNodes) {
+    const ownContent = renderNodeOwnContent(gameObject);
+    return wrapWithChildHosts(gameObject, _jsxs(_Fragment, { children: [ownContent, childNodes] }));
 }
-function renderNodeOwnContent(gameObject, ctx, isSelected, parentMatrix) {
+function renderNodeOwnContent(gameObject) {
     const geometry = findComponent(gameObject, "Geometry");
     const material = findComponent(gameObject, "Material");
     const geometryDef = geometry && getComponentDef(geometry.type);
     const materialDef = material && getComponentDef(material.type);
     if (!geometry || !(geometryDef === null || geometryDef === void 0 ? void 0 : geometryDef.View))
         return null;
-    const contextProps = buildContextProps(gameObject, ctx, isSelected);
-    return (_jsxs("mesh", { castShadow: true, receiveShadow: true, children: [_jsx(geometryDef.View, Object.assign({ properties: geometry.properties }, contextProps)), material && (materialDef === null || materialDef === void 0 ? void 0 : materialDef.View) && (_jsx(materialDef.View, Object.assign({ properties: material.properties }, contextProps), "material"))] }));
+    return (_jsxs("mesh", { castShadow: true, receiveShadow: true, children: [_jsx(geometryDef.View, { properties: geometry.properties }), material && (materialDef === null || materialDef === void 0 ? void 0 : materialDef.View) && (_jsx(materialDef.View, { properties: material.properties }, "material"))] }));
 }
-function wrapWithChildHosts(gameObject, ctx, isSelected, parentMatrix, subtree) {
-    const contextProps = buildContextProps(gameObject, ctx, isSelected);
+function wrapWithChildHosts(gameObject, subtree) {
     const childHosts = getChildHostComponents(gameObject);
-    return childHosts.reduce((acc, { key, View, properties }) => (_jsx(View, Object.assign({ properties: properties }, contextProps, { children: acc }), key)), subtree);
+    return childHosts.reduce((acc, { key, View, properties }) => (_jsx(View, { properties: properties, children: acc }, key)), subtree);
 }
 export default PrefabRoot;
 function missingStoreState() {

package/dist/tools/prefabeditor/components/CameraComponent.js

@@ -3,6 +3,7 @@ import { PerspectiveCamera, useHelper } from '@react-three/drei';
 import { useRef } from 'react';
 import { CameraHelper } from 'three';
 import { useFrame } from '@react-three/fiber';
+import { useEntityRuntime } from '../runtimeContext';
 import { FieldGroup, NumberField } from './Input';
 const cameraDefaults = {
     fov: 50,
@@ -14,7 +15,8 @@ function CameraComponentEditor({ component, onUpdate }) {
     const values = Object.assign(Object.assign({}, cameraDefaults), component.properties);
     return (_jsxs(FieldGroup, { children: [_jsx(NumberField, { name: "fov", label: "FOV", values: values, onChange: onUpdate, fallback: 50, min: 1, max: 179, step: 1 }), _jsx(NumberField, { name: "near", label: "Near", values: values, onChange: onUpdate, fallback: 0.1, min: 0.001, step: 0.1 }), _jsx(NumberField, { name: "zoom", label: "Zoom", values: values, onChange: onUpdate, fallback: 1, min: 0.01, step: 0.1 }), _jsx(NumberField, { name: "far", label: "Far", values: values, onChange: onUpdate, fallback: 1000, min: 0.1, step: 1 })] }));
 }
-function CameraComponentView({ properties, children, editMode, isSelected }) {
+function CameraComponentView({ properties, children }) {
+    const { editMode, isSelected } = useEntityRuntime();
     const merged = Object.assign(Object.assign({}, cameraDefaults), properties);
     const fov = merged.fov;
     const near = merged.near;

package/dist/tools/prefabeditor/components/ClickComponent.js

@@ -1,12 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useRef } from 'react';
 import { gameEvents } from '../GameEvents';
+import { useEntityRuntime } from '../runtimeContext';
 import { FieldGroup, StringField } from './Input';
 function ClickComponentEditor({ component, onUpdate }) {
     return (_jsxs(FieldGroup, { children: [_jsx("div", { style: { fontSize: 12, opacity: 0.8 }, children: "Emits a game event in play mode when this entity is clicked." }), _jsx(StringField, { name: "eventName", label: "Emit Event", values: component.properties, onChange: onUpdate, placeholder: "click" })] }));
 }
-function ClickComponentView({ children, editMode, nodeId, properties }) {
+function ClickComponentView({ children, properties }) {
     const clickValid = useRef(false);
+    const { editMode, nodeId } = useEntityRuntime();
     const eventName = (properties === null || properties === void 0 ? void 0 : properties.eventName) || 'click';
     const emitClick = (event) => {
         if (!nodeId)

package/dist/tools/prefabeditor/components/ComponentRegistry.d.ts

@@ -10,12 +10,6 @@ export interface ComponentViewProps<P = Record<string, any>> {
     properties: P;
     /** Children to render (for wrapper / child-host components). */
     children?: React.ReactNode;
-    /** The entity ID this component belongs to. */
-    nodeId?: string;
-    /** True when the editor is in edit mode. */
-    editMode?: boolean;
-    /** True when this entity is selected in the editor. */
-    isSelected?: boolean;
     /** Entity local position (passed to wrapper components like Physics). */
     position?: [number, number, number];
     /** Entity local rotation in radians (passed to wrapper components like Physics). */

package/dist/tools/prefabeditor/components/DirectionalLightComponent.js

@@ -3,6 +3,7 @@ import { useHelper } from "@react-three/drei";
 import { useRef, useEffect, useState } from "react";
 import { useFrame } from "@react-three/fiber";
 import { CameraHelper, Vector3 } from "three";
+import { useEntityRuntime } from "../runtimeContext";
 import { BooleanField, ColorField, NumberField, NumberInput, Vector3Input } from "./Input";
 import { LightSection, ShadowBiasField, mergeWithDefaults } from "./lightUtils";
 import { colors } from "../styles";
@@ -100,7 +101,8 @@ function DirectionalLightComponentEditor({ component, onUpdate }) {
     const values = mergeWithDefaults(directionalLightDefaults, component.properties);
     return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 8 }, children: [_jsxs(LightSection, { title: "Light", children: [_jsx(ColorField, { name: "color", label: "Color", values: values, onChange: onUpdate }), _jsx(NumberField, { name: "intensity", label: "Intensity", values: values, onChange: onUpdate, min: 0, step: 0.1, fallback: 1 }), _jsx(Vector3Input, { label: "Target Offset", value: values.targetOffset, onChange: targetOffset => onUpdate({ targetOffset }), snap: 0.5 })] }), _jsxs(LightSection, { title: "Shadow", children: [_jsx(BooleanField, { name: "castShadow", label: "Cast Shadow", values: values, onChange: onUpdate, fallback: false }), values.castShadow ? (_jsxs(_Fragment, { children: [_jsx(BooleanField, { name: "shadowAutoUpdate", label: "Auto Update", values: values, onChange: onUpdate, fallback: true }), _jsx(NumberField, { name: "shadowMapSize", label: "Map Size", values: values, onChange: onUpdate, min: 128, step: 128, fallback: 512 }), _jsx(ShadowBiasField, { name: "shadowBias", label: "Bias", values: values, onChange: onUpdate, fallback: 0 }), _jsx(ShadowBiasField, { name: "shadowNormalBias", label: "Normal Bias", values: values, onChange: onUpdate, fallback: 0 }), _jsx(NumberField, { name: "shadowCameraNear", label: "Near", values: values, onChange: onUpdate, min: 0.001, step: 0.1, fallback: 0.5 }), _jsx(NumberField, { name: "shadowCameraFar", label: "Far", values: values, onChange: onUpdate, min: 0.1, step: 1, fallback: 500 }), _jsx(ShadowFrustumField, { values: values, onChange: onUpdate })] })) : null] })] }));
 }
-function DirectionalLightView({ properties, children, editMode, isSelected }) {
+function DirectionalLightView({ properties, children }) {
+    const { editMode, isSelected } = useEntityRuntime();
     const merged = mergeWithDefaults(directionalLightDefaults, properties);
     const color = merged.color;
     const intensity = merged.intensity;

package/dist/tools/prefabeditor/components/EnvironmentComponent.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Environment } from '@react-three/drei';
 import { FieldGroup, NumberField } from './Input';
-import { useSceneRuntime } from '../PrefabRoot';
+import { useAssetRuntime } from '../runtimeContext';
 function EnvironmentView({ properties, children, }) {
-    const { getAssetRevision } = useSceneRuntime();
+    const { getAssetRevision } = useAssetRuntime();
     const { intensity = 1, resolution = 256 } = properties;
     const environmentRevision = `${getAssetRevision()}::${intensity}::${resolution}`;
     return (_jsx(Environment, { background: true, environmentIntensity: intensity, resolution: resolution, frames: 1, children: children }, environmentRevision));

package/dist/tools/prefabeditor/components/MaterialComponent.js

@@ -12,7 +12,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { extend } from '@react-three/fiber';
 import { FieldRenderer, Label, NumberInput } from './Input';
-import { useSceneRuntime } from '../PrefabRoot';
+import { useAssetRuntime } from '../runtimeContext';
 import { useMemo } from 'react';
 import { MeshBasicNodeMaterial, MeshStandardNodeMaterial } from 'three/webgpu';
 import { TexturePicker } from '../../assetviewer/page';
@@ -122,7 +122,7 @@ function MaterialComponentEditor({ component, onUpdate, basePath = "" }) {
 // View for Material component
 function MaterialComponentView({ properties: rawProps }) {
     var _a, _b, _c, _d, _e;
-    const { getTexture } = useSceneRuntime();
+    const { getTexture } = useAssetRuntime();
     const properties = rawProps;
     const materialType = (_a = properties === null || properties === void 0 ? void 0 : properties.materialType) !== null && _a !== void 0 ? _a : 'standard';
     const textureName = properties === null || properties === void 0 ? void 0 : properties.texture;

package/dist/tools/prefabeditor/components/ModelComponent.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { ModelPicker } from '../../assetviewer/page';
 import { useContext, useMemo } from 'react';
 import { BooleanField, FieldGroup, Label, ListEditor, NumberInput, SelectInput } from './Input';
-import { useSceneRuntime } from '../PrefabRoot';
+import { useAssetRuntime } from '../runtimeContext';
 import { EditorContext } from '../PrefabEditor';
 import { DEFAULT_REPEAT_AXES, getRepeatAxesFromModelProperties, normalizeRepeatAxes } from '../InstanceProvider';
 import { colors } from '../styles';
@@ -65,7 +65,7 @@ function ModelComponentEditor({ component, node, onUpdate, basePath = "" }) {
 }
 // View for Model component
 function ModelComponentView({ properties, children }) {
-    const { getModel } = useSceneRuntime();
+    const { getModel } = useAssetRuntime();
     // Instanced models are handled elsewhere (GameInstance), so only render non-instanced here
     if (!properties.filename || properties.instanced)
         return _jsx(_Fragment, { children: children });

package/dist/tools/prefabeditor/components/PhysicsComponent.js

@@ -12,7 +12,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { CapsuleCollider, RigidBody, useRapier } from "@react-three/rapier";
 import { useRef, useEffect, useCallback } from 'react';
-import { useSceneRuntime } from "../PrefabRoot";
+import { useAssetRuntime, useEntityRuntime } from "../runtimeContext";
 import { BooleanField, FieldGroup, ListEditor, NumberField, SelectField, SelectInput, StringInput, Vector3Field } from "./Input";
 import { gameEvents, getEntityIdFromRigidBody } from "../GameEvents";
 import { colors } from "../styles";
@@ -163,8 +163,9 @@ function PhysicsComponentEditor({ component, onUpdate }) {
                     { value: 'all', label: 'All (includes kinematic & fixed)' },
                 ] })] }));
 }
-function PhysicsComponentView({ properties, children, position, rotation, scale, editMode, nodeId }) {
-    const { registerRigidBodyRef } = useSceneRuntime();
+function PhysicsComponentView({ properties, children, position, rotation, scale }) {
+    const { registerRigidBodyRef } = useAssetRuntime();
+    const { editMode, nodeId } = useEntityRuntime();
     const { type, colliders, sensor, activeCollisionTypes, linearVelocity = [0, 0, 0], angularVelocity = [0, 0, 0], capsuleRadius = capsuleRadiusFallback, capsuleHalfHeight = capsuleHalfHeightFallback, sensorEnterEventName, sensorExitEventName, collisionEnterEventName, collisionExitEventName, enabledTranslations = enabledAxesFallback, enabledRotations = enabledAxesFallback } = properties, otherProps = __rest(properties, ["type", "colliders", "sensor", "activeCollisionTypes", "linearVelocity", "angularVelocity", "capsuleRadius", "capsuleHalfHeight", "sensorEnterEventName", "sensorExitEventName", "collisionEnterEventName", "collisionExitEventName", "enabledTranslations", "enabledRotations"]);
     const colliderType = colliders || (type === 'fixed' ? 'trimesh' : 'hull');
     const usesManualCapsuleCollider = colliderType === 'capsule';

package/dist/tools/prefabeditor/components/PointLightComponent.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useEffect, useRef } from 'react';
 import { useHelper } from '@react-three/drei';
 import { PointLightHelper } from 'three';
+import { useEntityRuntime } from '../runtimeContext';
 import { BooleanField, ColorField, NumberField } from './Input';
 import { LightSection, ShadowBiasField, mergeWithDefaults } from './lightUtils';
 const pointLightDefaults = {
@@ -21,7 +22,8 @@ function PointLightComponentEditor({ component, onUpdate }) {
     const values = mergeWithDefaults(pointLightDefaults, component.properties);
     return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 8 }, children: [_jsxs(LightSection, { title: "Light", children: [_jsx(ColorField, { name: "color", label: "Color", values: values, onChange: onUpdate }), _jsx(NumberField, { name: "intensity", label: "Intensity", values: values, onChange: onUpdate, min: 0, step: 0.1, fallback: 1 }), _jsx(NumberField, { name: "distance", label: "Distance", values: values, onChange: onUpdate, min: 0, step: 1, fallback: 0 }), _jsx(NumberField, { name: "decay", label: "Decay", values: values, onChange: onUpdate, min: 0, step: 0.1, fallback: 2 })] }), _jsxs(LightSection, { title: "Shadow", children: [_jsx(BooleanField, { name: "castShadow", label: "Cast Shadow", values: values, onChange: onUpdate, fallback: false }), values.castShadow ? (_jsxs(_Fragment, { children: [_jsx(BooleanField, { name: "shadowAutoUpdate", label: "Auto Update", values: values, onChange: onUpdate, fallback: true }), _jsx(NumberField, { name: "shadowMapSize", label: "Map Size", values: values, onChange: onUpdate, min: 128, step: 128, fallback: 512 }), _jsx(ShadowBiasField, { name: "shadowBias", label: "Bias", values: values, onChange: onUpdate, fallback: 0 }), _jsx(ShadowBiasField, { name: "shadowNormalBias", label: "Normal Bias", values: values, onChange: onUpdate, fallback: 0 }), _jsx(NumberField, { name: "shadowCameraNear", label: "Near", values: values, onChange: onUpdate, min: 0.001, step: 0.1, fallback: 0.5 }), _jsx(NumberField, { name: "shadowCameraFar", label: "Far", values: values, onChange: onUpdate, min: 0.1, step: 1, fallback: 500 })] })) : null] })] }));
 }
-function PointLightView({ properties, children, editMode, isSelected }) {
+function PointLightView({ properties, children }) {
+    const { editMode, isSelected } = useEntityRuntime();
     const merged = mergeWithDefaults(pointLightDefaults, properties);
     const color = merged.color;
     const intensity = merged.intensity;

package/dist/tools/prefabeditor/components/SoundComponent.js

@@ -4,7 +4,7 @@ import { useThree } from '@react-three/fiber';
 import { SoundPicker } from '../../assetviewer/page';
 import { sound as soundManager } from '../../../helpers/SoundManager';
 import { gameEvents } from '../GameEvents';
-import { useSceneRuntime } from '../PrefabRoot';
+import { useAssetRuntime, useEntityRuntime } from '../runtimeContext';
 import { BooleanField, FieldGroup, FieldRenderer, ListEditor, NumberField, SelectField, StringField } from './Input';
 import { colors } from '../styles';
 import { AudioListener } from 'three';
@@ -123,8 +123,9 @@ function payloadMatchesNode(nodeId, payload) {
     const hasEntityIds = ids.some(id => typeof id === 'string');
     return hasEntityIds ? ids.includes(nodeId) : true;
 }
-function SoundComponentView({ properties, editMode, nodeId, children }) {
-    const { getSound } = useSceneRuntime();
+function SoundComponentView({ properties, children }) {
+    const { getSound } = useAssetRuntime();
+    const { editMode, nodeId } = useEntityRuntime();
     const { camera } = useThree();
     const { eventName, positional = false, refDistance = 1, maxDistance = 24, rolloffFactor = 1, distanceModel = 'inverse' } = properties;
     const sequenceIndexRef = useRef(0);

package/dist/tools/prefabeditor/components/SpotLightComponent.js

@@ -3,7 +3,7 @@ import { useHelper } from "@react-three/drei";
 import { useRef, useEffect } from "react";
 import { BooleanField, ColorField, Label, NumberField, Vector3Input } from "./Input";
 import { SpotLightHelper } from "three";
-import { useSceneRuntime } from "../PrefabRoot";
+import { useAssetRuntime, useEntityRuntime } from "../runtimeContext";
 import { useFrame } from "@react-three/fiber";
 import { TexturePicker } from "../../assetviewer/page";
 import { LightSection, ShadowBiasField, mergeWithDefaults } from "./lightUtils";
@@ -28,9 +28,10 @@ function SpotLightComponentEditor({ component, onUpdate, basePath = "" }) {
     const values = mergeWithDefaults(spotLightDefaults, component.properties);
     return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 8 }, children: [_jsxs(LightSection, { title: "Light", children: [_jsx(ColorField, { name: "color", label: "Color", values: values, onChange: onUpdate }), _jsx(NumberField, { name: "intensity", label: "Intensity", values: values, onChange: onUpdate, min: 0, step: 0.1, fallback: 1 }), _jsx(NumberField, { name: "angle", label: "Angle", values: values, onChange: onUpdate, min: 0, max: Math.PI / 2, step: 0.05, fallback: Math.PI / 3 }), _jsx(NumberField, { name: "penumbra", label: "Penumbra", values: values, onChange: onUpdate, min: 0, max: 1, step: 0.05, fallback: 0 }), _jsx(NumberField, { name: "distance", label: "Distance", values: values, onChange: onUpdate, min: 0, step: 1, fallback: 0 }), _jsx(NumberField, { name: "decay", label: "Decay", values: values, onChange: onUpdate, min: 0, step: 0.1, fallback: 2 }), _jsx(Vector3Input, { label: "Target Offset", value: values.targetOffset, onChange: targetOffset => onUpdate({ targetOffset }), snap: 0.5 }), _jsxs("div", { children: [_jsx(Label, { children: "Texture Map" }), _jsx(TexturePicker, { value: values.map, onChange: (map) => onUpdate({ map }), basePath: basePath })] })] }), _jsxs(LightSection, { title: "Shadow", children: [_jsx(BooleanField, { name: "castShadow", label: "Cast Shadow", values: values, onChange: onUpdate, fallback: false }), values.castShadow ? (_jsxs(_Fragment, { children: [_jsx(BooleanField, { name: "shadowAutoUpdate", label: "Auto Update", values: values, onChange: onUpdate, fallback: true }), _jsx(NumberField, { name: "shadowMapSize", label: "Map Size", values: values, onChange: onUpdate, min: 128, step: 128, fallback: 512 }), _jsx(ShadowBiasField, { name: "shadowBias", label: "Bias", values: values, onChange: onUpdate, fallback: 0 }), _jsx(ShadowBiasField, { name: "shadowNormalBias", label: "Normal Bias", values: values, onChange: onUpdate, fallback: 0 }), _jsx(NumberField, { name: "shadowCameraNear", label: "Near", values: values, onChange: onUpdate, min: 0.001, step: 0.1, fallback: 0.5 }), _jsx(NumberField, { name: "shadowCameraFar", label: "Far", values: values, onChange: onUpdate, min: 0.1, step: 1, fallback: 500 })] })) : null] })] }));
 }
-function SpotLightView({ properties, children, editMode, isSelected }) {
+function SpotLightView({ properties, children }) {
     var _a;
-    const { getTexture } = useSceneRuntime();
+    const { getTexture } = useAssetRuntime();
+    const { editMode, isSelected } = useEntityRuntime();
     const merged = mergeWithDefaults(spotLightDefaults, properties);
     const color = merged.color;
     const intensity = merged.intensity;

package/dist/tools/prefabeditor/components/index.d.ts

@@ -1,2 +1 @@
-declare const _default: import("./ComponentRegistry").Component[];
-export default _default;
+export declare const builtinComponents: import("./ComponentRegistry").Component[];

package/dist/tools/prefabeditor/components/index.js

@@ -12,7 +12,7 @@ import EnvironmentComponent from './EnvironmentComponent';
 import CameraComponent from './CameraComponent';
 import ClickComponent from './ClickComponent';
 import SoundComponent from './SoundComponent';
-export default [
+export const builtinComponents = [
     GeometryComponent,
     TransformComponent,
     MaterialComponent,

package/dist/tools/prefabeditor/runtimeContext.d.ts

@@ -0,0 +1,40 @@
+import { type ReactNode } from "react";
+import { Object3D, Texture } from "three";
+type RuntimeScopeProps = {
+    nodeId: string;
+    editMode?: boolean;
+    isSelected?: boolean;
+    children: ReactNode;
+};
+export interface AssetRuntime {
+    registerRigidBodyRef: (id: string, rb: any) => void;
+    getModel: (path: string) => Object3D | null;
+    getTexture: (path: string) => Texture | null;
+    getSound: (path: string) => AudioBuffer | null;
+    getAssetRevision: () => string;
+}
+export interface AssetRuntimeContextValue extends AssetRuntime {
+    getObject: (id: string) => Object3D | null;
+    getRigidBody: (id: string) => any;
+}
+export interface EntityRuntime {
+    nodeId: string;
+    editMode?: boolean;
+    isSelected?: boolean;
+    getObject: <T extends Object3D = Object3D>() => T | null;
+    getRigidBody: <T = any>() => T | null;
+}
+export interface LiveObjectRef<T extends Object3D = Object3D> {
+    readonly current: T | null;
+}
+export interface LiveRigidBodyRef<T = any> {
+    readonly current: T | null;
+}
+export declare const AssetRuntimeContext: import("react").Context<AssetRuntimeContextValue | null>;
+export declare const EntityRuntimeContext: import("react").Context<EntityRuntime | null>;
+export declare function useAssetRuntime(): AssetRuntime;
+export declare function useEntityRuntime(): EntityRuntime;
+export declare function useEntityObjectRef<T extends Object3D = Object3D>(): LiveObjectRef<T>;
+export declare function useEntityRigidBodyRef<T = any>(): LiveRigidBodyRef<T>;
+export declare function EntityRuntimeScope({ nodeId, editMode, isSelected, children, }: RuntimeScopeProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tools/prefabeditor/runtimeContext.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+function createLiveRef(getCurrent) {
+    return {
+        get current() {
+            return getCurrent();
+        },
+    };
+}
+export const AssetRuntimeContext = createContext(null);
+export const EntityRuntimeContext = createContext(null);
+export function useAssetRuntime() {
+    const ctx = useContext(AssetRuntimeContext);
+    if (!ctx)
+        throw new Error("useAssetRuntime must be used inside <PrefabRoot>");
+    return ctx;
+}
+export function useEntityRuntime() {
+    const ctx = useContext(EntityRuntimeContext);
+    if (!ctx)
+        throw new Error("useEntityRuntime must be used inside a component View rendered by <PrefabRoot>");
+    return ctx;
+}
+export function useEntityObjectRef() {
+    const { getObject } = useEntityRuntime();
+    return useMemo(() => createLiveRef(() => getObject()), [getObject]);
+}
+export function useEntityRigidBodyRef() {
+    const { getRigidBody } = useEntityRuntime();
+    return useMemo(() => createLiveRef(() => getRigidBody()), [getRigidBody]);
+}
+export function EntityRuntimeScope({ nodeId, editMode, isSelected, children, }) {
+    const assetRuntime = useContext(AssetRuntimeContext);
+    if (!assetRuntime)
+        throw new Error("EntityRuntimeScope must be used inside <PrefabRoot>");
+    const { getObject, getRigidBody } = assetRuntime;
+    const value = useMemo(() => ({
+        nodeId,
+        editMode,
+        isSelected,
+        getObject: () => getObject(nodeId),
+        getRigidBody: () => getRigidBody(nodeId),
+    }), [editMode, getObject, getRigidBody, isSelected, nodeId]);
+    return _jsx(EntityRuntimeContext.Provider, { value: value, children: children });
+}

package/dist/tools/prefabeditor/scene.d.ts

@@ -1,3 +1,4 @@
+import type { Object3D } from "three";
 import type { GameObject } from "./types";
 export interface SpawnOptions {
     name?: string;
@@ -19,6 +20,8 @@ export interface Entity {
     readonly enabled: boolean;
     readonly parent: Entity | null;
     readonly children: Entity[];
+    readonly object: Object3D | null;
+    readonly rigidBody: any;
     set: (data: EntityData) => void;
     update: (update: (node: EntityData) => EntityData) => void;
     getComponent: <TProperties = Record<string, any>>(name: string) => EntityComponent<TProperties> | null;
@@ -30,7 +33,7 @@ export type EntityUpdate = (node: EntityData) => EntityData;
 export type SceneUpdates = Record<string, EntityUpdate>;
 export interface Scene {
     readonly rootId: string;
-    find: (nameOrId: string) => Entity | null;
+    find: (id: string) => Entity | null;
     get: (id: string) => Entity;
     create: (name: string, components?: Record<string, {
         type: string;
@@ -48,11 +51,12 @@ interface SceneAdapter {
     getNode: (id: string) => EntityData | null;
     getChildIds: (id: string) => string[];
     getParentId: (id: string) => string | null;
-    findByName: (name: string) => string | null;
     updateNode: (id: string, update: (node: EntityData) => EntityData) => void;
     updateNodes: (updates: Record<string, (node: EntityData) => EntityData>) => void;
     addNode: (node: GameObject, options?: SpawnOptions) => string;
     removeNode: (id: string) => void;
+    getObject?: (id: string) => Object3D | null;
+    getRigidBody?: (id: string) => any;
 }
 export declare function createScene(adapter: SceneAdapter): Scene;
 export {};

package/dist/tools/prefabeditor/scene.js

@@ -119,6 +119,14 @@ export function createScene(adapter) {
             get children() {
                 return adapter.getChildIds(id).map(createNode);
             },
+            get object() {
+                var _a, _b;
+                return (_b = (_a = adapter.getObject) === null || _a === void 0 ? void 0 : _a.call(adapter, id)) !== null && _b !== void 0 ? _b : null;
+            },
+            get rigidBody() {
+                var _a, _b;
+                return (_b = (_a = adapter.getRigidBody) === null || _a === void 0 ? void 0 : _a.call(adapter, id)) !== null && _b !== void 0 ? _b : null;
+            },
             set(data) {
                 adapter.updateNode(id, () => data);
             },
@@ -173,11 +181,8 @@ export function createScene(adapter) {
         get rootId() {
             return adapter.getRootId();
         },
-        find(nameOrId) {
-            if (adapter.getNode(nameOrId))
-                return createNode(nameOrId);
-            const foundId = adapter.findByName(nameOrId);
-            return foundId ? createNode(foundId) : null;
+        find(id) {
+            return adapter.getNode(id) ? createNode(id) : null;
         },
         get: getNode,
         create(name, components, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-three-game",
-  "version": "0.0.71",
+  "version": "0.0.73",
   "description": "high performance 3D game engine built in React",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/dist/tools/prefabeditor/RefBridge.d.ts

@@ -1,24 +0,0 @@
-import { Object3D } from "three";
-/**
- * RefBridge — O(1) lookup from entity ID to live Three.js Object3D.
- *
- * In play mode the Scene API writes directly to these refs, bypassing
- * React reconciliation.  In edit mode the store path is used instead.
- *
- * Component Views register/unregister refs on mount/unmount via
- * `bridge.register(id, obj)` / `bridge.unregister(id)`.
- */
-export interface RefBridge {
-    register: (id: string, obj: Object3D | null) => void;
-    unregister: (id: string) => void;
-    get: (id: string) => Object3D | null;
-    /** Apply a transform component's properties directly to the Object3D. */
-    setTransform: (id: string, position?: number[], rotation?: number[], scale?: number[]) => void;
-    /** Read current transform from the Object3D back into a properties bag. */
-    readTransform: (id: string) => {
-        position: [number, number, number];
-        rotation: [number, number, number];
-        scale: [number, number, number];
-    } | null;
-}
-export declare function createRefBridge(): RefBridge;

package/dist/tools/prefabeditor/RefBridge.js

@@ -1,44 +0,0 @@
-export function createRefBridge() {
-    const refs = new Map();
-    return {
-        register(id, obj) {
-            if (obj) {
-                refs.set(id, obj);
-            }
-            else {
-                refs.delete(id);
-            }
-        },
-        unregister(id) {
-            refs.delete(id);
-        },
-        get(id) {
-            var _a;
-            return (_a = refs.get(id)) !== null && _a !== void 0 ? _a : null;
-        },
-        setTransform(id, position, rotation, scale) {
-            const obj = refs.get(id);
-            if (!obj)
-                return;
-            if (position) {
-                obj.position.set(position[0], position[1], position[2]);
-            }
-            if (rotation) {
-                obj.rotation.set(rotation[0], rotation[1], rotation[2]);
-            }
-            if (scale) {
-                obj.scale.set(scale[0], scale[1], scale[2]);
-            }
-        },
-        readTransform(id) {
-            const obj = refs.get(id);
-            if (!obj)
-                return null;
-            return {
-                position: [obj.position.x, obj.position.y, obj.position.z],
-                rotation: [obj.rotation.x, obj.rotation.y, obj.rotation.z],
-                scale: [obj.scale.x, obj.scale.y, obj.scale.z],
-            };
-        },
-    };
-}