react-three-game 0.0.107 → 0.0.108

package/dist/plugins/crashcat/CrashcatRuntime.js

@@ -33,11 +33,14 @@ function setCrashcatApi(api) {
         listener();
     });
 }
-function emitConfiguredEvent(eventName, sourceNodeId, targetNodeId, collisionNormal) {
-    const trimmed = eventName === null || eventName === void 0 ? void 0 : eventName.trim();
-    if (!trimmed)
+function emitPhysicsEvent(eventType, eventName, sourceNodeId, targetNodeId, collisionNormal) {
+    const alias = eventName === null || eventName === void 0 ? void 0 : eventName.trim();
+    if (!gameEvents.hasListeners(eventType) && (!alias || !gameEvents.hasListeners(alias)))
         return;
-    gameEvents.emit(trimmed, Object.assign({ sourceEntityId: sourceNodeId, sourceNodeId, targetEntityId: targetNodeId, targetNodeId }, (collisionNormal ? { collisionNormal } : {})));
+    const payload = Object.assign({ sourceEntityId: sourceNodeId, sourceNodeId, targetEntityId: targetNodeId, targetNodeId }, (collisionNormal ? { collisionNormal } : {}));
+    gameEvents.emit(eventType, payload);
+    if (alias)
+        gameEvents.emit(alias, payload);
 }
 function createDebugState() {
     const options = debugRenderer.createDefaultOptions();
@@ -71,26 +74,27 @@ export function CrashcatRuntime({ debug = false, children }) {
     const [debugState] = useState(() => debug ? createDebugState() : null);
     const listener = useMemo(() => ({
         onContactAdded: (bodyA, bodyB, manifold) => {
-            var _a, _b;
+            var _a, _b, _c, _d, _e, _f;
             const metaA = getBodyMeta(bodyByIdRef.current, bodyA);
             const metaB = getBodyMeta(bodyByIdRef.current, bodyB);
             const n = manifold === null || manifold === void 0 ? void 0 : manifold.worldSpaceNormal;
             const nA = n ? [n[0], n[1], n[2]] : undefined;
             const nB = n ? [-n[0], -n[1], -n[2]] : undefined;
-            if (metaA === null || metaA === void 0 ? void 0 : metaA.events)
-                emitConfiguredEvent(metaA.sensor ? metaA.events.sensorEnter : metaA.events.collisionEnter, metaA.nodeId, (_a = metaB === null || metaB === void 0 ? void 0 : metaB.nodeId) !== null && _a !== void 0 ? _a : null, nA);
-            if (metaB === null || metaB === void 0 ? void 0 : metaB.events)
-                emitConfiguredEvent(metaB.sensor ? metaB.events.sensorEnter : metaB.events.collisionEnter, metaB.nodeId, (_b = metaA === null || metaA === void 0 ? void 0 : metaA.nodeId) !== null && _b !== void 0 ? _b : null, nB);
+            if (metaA)
+                emitPhysicsEvent(metaA.sensor ? "sensor:enter" : "collision:enter", metaA.sensor ? (_a = metaA.events) === null || _a === void 0 ? void 0 : _a.sensorEnter : (_b = metaA.events) === null || _b === void 0 ? void 0 : _b.collisionEnter, metaA.nodeId, (_c = metaB === null || metaB === void 0 ? void 0 : metaB.nodeId) !== null && _c !== void 0 ? _c : null, nA);
+            if (metaB)
+                emitPhysicsEvent(metaB.sensor ? "sensor:enter" : "collision:enter", metaB.sensor ? (_d = metaB.events) === null || _d === void 0 ? void 0 : _d.sensorEnter : (_e = metaB.events) === null || _e === void 0 ? void 0 : _e.collisionEnter, metaB.nodeId, (_f = metaA === null || metaA === void 0 ? void 0 : metaA.nodeId) !== null && _f !== void 0 ? _f : null, nB);
         },
         onContactRemoved: (idA, idB) => {
-            var _a, _b;
+            var _a, _b, _c, _d, _e, _f;
             const metaA = bodyByIdRef.current.get(Number(idA));
             const metaB = bodyByIdRef.current.get(Number(idB));
-            if (metaA === null || metaA === void 0 ? void 0 : metaA.events)
-                emitConfiguredEvent(metaA.sensor ? metaA.events.sensorExit : metaA.events.collisionExit, metaA.nodeId, (_a = metaB === null || metaB === void 0 ? void 0 : metaB.nodeId) !== null && _a !== void 0 ? _a : null);
-            if (metaB === null || metaB === void 0 ? void 0 : metaB.events)
-                emitConfiguredEvent(metaB.sensor ? metaB.events.sensorExit : metaB.events.collisionExit, metaB.nodeId, (_b = metaA === null || metaA === void 0 ? void 0 : metaA.nodeId) !== null && _b !== void 0 ? _b : null);
+            if (metaA)
+                emitPhysicsEvent(metaA.sensor ? "sensor:exit" : "collision:exit", metaA.sensor ? (_a = metaA.events) === null || _a === void 0 ? void 0 : _a.sensorExit : (_b = metaA.events) === null || _b === void 0 ? void 0 : _b.collisionExit, metaA.nodeId, (_c = metaB === null || metaB === void 0 ? void 0 : metaB.nodeId) !== null && _c !== void 0 ? _c : null);
+            if (metaB)
+                emitPhysicsEvent(metaB.sensor ? "sensor:exit" : "collision:exit", metaB.sensor ? (_d = metaB.events) === null || _d === void 0 ? void 0 : _d.sensorExit : (_e = metaB.events) === null || _e === void 0 ? void 0 : _e.collisionExit, metaB.nodeId, (_f = metaA === null || metaA === void 0 ? void 0 : metaA.nodeId) !== null && _f !== void 0 ? _f : null);
         },
+        onBodyPairValidate: (bodyA, bodyB) => !rigidBody.bodiesShareConstraint(bodyA, bodyB),
     }), []);
     useEffect(() => {
         ensureCrashcatRegistered();

package/dist/plugins/crashcat/index.d.ts

@@ -1,2 +1,3 @@
 export { CrashcatRuntime, useCrashcat, type BodyMeta, type CrashcatApi, type CrashcatEventConfig, } from "./CrashcatRuntime";
 export { default as CrashcatPhysicsComponent, default, } from "./CrashcatPhysicsComponent";
+export { CrashcatRagdoll, default as CrashcatRagdollComponent, RagdollBodyPart, createRagdollSettings, createStaticBoxBody, type CrashcatRagdollProps, type RagdollSettings, } from "./CrashcatRagdoll";

package/dist/plugins/crashcat/index.js

@@ -1,2 +1,3 @@
 export { CrashcatRuntime, useCrashcat, } from "./CrashcatRuntime";
 export { default as CrashcatPhysicsComponent, default, } from "./CrashcatPhysicsComponent";
+export { CrashcatRagdoll, default as CrashcatRagdollComponent, RagdollBodyPart, createRagdollSettings, createStaticBoxBody, } from "./CrashcatRagdoll";

package/dist/tools/assetviewer/page.js

@@ -5,7 +5,7 @@ import { Suspense, useEffect, useLayoutEffect, useState, useRef } from "react";
 import { createPortal } from 'react-dom';
 import { Mesh, TextureLoader } from "three";
 import { loadModel } from "../dragdrop/modelLoader";
-import { resolvePrefabAssetPath } from "../prefabeditor/PrefabEditor";
+import { withBasePath } from "../prefabeditor/utils";
 import { base, colors, fonts } from "../prefabeditor/styles";
 const styles = {
     errorIcon: { color: colors.danger, fontSize: 12 },
@@ -126,7 +126,7 @@ function TextureCard({ file, onSelect, basePath = "" }) {
     const [isHovered, setIsHovered] = useState(false);
     const [error, setError] = useState(false);
     const { ref, isInView } = useInView();
-    const fullPath = resolvePrefabAssetPath(basePath, file);
+    const fullPath = withBasePath(basePath, file);
     const fileName = file.split('/').pop();
     if (error) {
         return (_jsxs("div", { ref: ref, style: Object.assign(Object.assign({ maxWidth: 60, aspectRatio: '1 / 1' }, assetTileStyle), { backgroundColor: assetViewerColors.errorBg }), onClick: () => onSelect(file), title: `Could not load ${file}`, children: [_jsx("div", { style: { flex: 1, display: 'flex', alignItems: 'center', justifyContent: 'center' }, children: _jsx("div", { style: styles.errorIcon, children: "\u2717" }) }), _jsx("div", { style: styles.bottomLabel, children: fileName })] }));
@@ -170,7 +170,7 @@ export function ModelListViewer({ files, selected, onSelect, basePath = "" }) {
 function ModelCard({ file, onSelect, basePath = "", size = 60, }) {
     const [error, setError] = useState(false);
     const { ref, isInView } = useInView();
-    const fullPath = resolvePrefabAssetPath(basePath, file);
+    const fullPath = withBasePath(basePath, file);
     if (error) {
         return (_jsx("div", { ref: ref, style: { aspectRatio: '1 / 1', backgroundColor: assetViewerColors.errorBg, cursor: 'pointer', display: 'flex', alignItems: 'center', justifyContent: 'center', border: `1px solid ${colors.dangerBorder}` }, onClick: () => onSelect(file), children: _jsx("div", { style: styles.errorIcon, children: "\u2717" }) }));
     }
@@ -215,7 +215,7 @@ export function SoundListViewer({ files, selected, onSelect, basePath = "" }) {
 }
 function SoundCard({ file, onSelect, basePath = "" }) {
     const fileName = file.split('/').pop() || '';
-    const fullPath = resolvePrefabAssetPath(basePath, file);
+    const fullPath = withBasePath(basePath, file);
     return (_jsxs("div", { onClick: () => onSelect(file), style: Object.assign(Object.assign({ aspectRatio: '1 / 1' }, assetTileStyle), { alignItems: 'center', justifyContent: 'center' }), children: [_jsx("div", { style: styles.iconLarge, children: "\uD83D\uDD0A" }), _jsx("div", { style: { color: colors.text, fontSize: fonts.size, padding: '0 4px', marginTop: 4, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', textAlign: 'center', width: '100%' }, children: fileName })] }));
 }
 const PICKER_POPUP_WIDTH = 260;

package/dist/tools/prefabeditor/EditorTree.js

@@ -4,7 +4,7 @@ import { base, colors, tree } from './styles';
 import { useEditorContext, useEditorRef } from './PrefabEditor';
 import { Dropdown } from './Dropdown';
 import { FileMenu, TreeContextMenu, TreeNodeMenu } from './EditorTreeMenus';
-import { createEmptyNode } from './prefab';
+import { createEmptyNode, createPackedPrefabNode } from './prefab';
 import { usePrefabChildIds, usePrefabNode, usePrefabRootId, usePrefabStore, usePrefabStoreApi } from './prefabStore';
 export default function EditorTree({ selectedId, setSelectedId, getPrefab, onReplacePrefab, onImportPrefab, onUndo, onRedo, canUndo, canRedo }) {
     const { onFocusNode } = useEditorContext();
@@ -30,6 +30,9 @@ export default function EditorTree({ selectedId, setSelectedId, getPrefab, onRep
         editor.add(newNode, parentId);
         setSelectedId(newNode.id);
     };
+    const handleImportPackedPrefab = (url) => {
+        editor.add(createPackedPrefabNode(url), rootId);
+    };
     const handleDuplicate = (nodeId) => {
         if (nodeId === rootId)
             return;
@@ -103,7 +106,7 @@ export default function EditorTree({ selectedId, setSelectedId, getPrefab, onRep
     return (_jsxs(_Fragment, { children: [_jsxs("div", { style: Object.assign(Object.assign({}, tree.panel), { width: collapsed ? 'auto' : 224 }), children: [_jsxs("div", { style: base.header, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 6, cursor: 'pointer' }, onClick: () => setCollapsed(!collapsed), children: [_jsx("span", { children: collapsed ? '▶' : '▼' }), _jsx("span", { children: "Prefab" })] }), !collapsed && (_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 4 }, children: [_jsx("button", { style: Object.assign(Object.assign({}, base.btn), { padding: '2px 6px', fontSize: 10, opacity: canUndo ? 1 : 0.4 }), onClick: (e) => { e.stopPropagation(); onUndo === null || onUndo === void 0 ? void 0 : onUndo(); }, disabled: !canUndo, title: "Undo", children: "\u21B6" }), _jsx("button", { style: Object.assign(Object.assign({}, base.btn), { padding: '2px 6px', fontSize: 10, opacity: canRedo ? 1 : 0.4 }), onClick: (e) => { e.stopPropagation(); onRedo === null || onRedo === void 0 ? void 0 : onRedo(); }, disabled: !canRedo, title: "Redo", children: "\u21B7" }), _jsx(Dropdown, { placement: "bottom-end", trigger: ({ ref, toggle }) => (_jsx("button", { ref: ref, title: "Menu", style: Object.assign(Object.assign({}, base.btn), { padding: '2px 6px', fontSize: 10 }), onClick: (e) => {
                                                 e.stopPropagation();
                                                 toggle();
-                                            }, children: "\u22EE" })), children: (close) => (_jsx(FileMenu, { getPrefab: getPrefab, onReplacePrefab: onReplacePrefab, onImportPrefab: onImportPrefab, onClose: close })) })] }))] }), !collapsed && (_jsxs(_Fragment, { children: [_jsx("div", { style: { padding: '4px 4px', borderBottom: `1px solid ${colors.borderLight}` }, children: _jsx("input", { type: "text", placeholder: "Search nodes...", value: searchQuery, onChange: (e) => setSearchQuery(e.target.value), onClick: (e) => e.stopPropagation(), style: Object.assign(Object.assign({}, base.input), { padding: '4px 8px' }) }) }), _jsx("div", { style: tree.scroll, children: _jsx(TreeNode, { nodeId: rootId, depth: 0, rootId: rootId, visibleIds: visibleIds, collapsedIds: collapsedIds, dropTarget: dropTarget, selectedNodeId: selectedId, onToggleCollapse: toggleCollapse, onOpenContextMenu: openContextMenu, onDragStart: handleDragStart, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, onDragEnd: () => { setDraggedId(null); setDropTarget(null); }, renderTreeNodeMenu: renderTreeNodeMenu, onToggleDisabled: handleToggleDisabled, setSelectedId: setSelectedId }) })] }))] }), _jsx(TreeContextMenu, { contextMenu: contextMenu, onClose: closeContextMenu, children: (nodeId, close) => renderTreeNodeMenu(nodeId, nodeId === rootId, close) })] }));
+                                            }, children: "\u22EE" })), children: (close) => (_jsx(FileMenu, { getPrefab: getPrefab, onReplacePrefab: onReplacePrefab, onImportPrefab: onImportPrefab, onImportPackedPrefab: handleImportPackedPrefab, onClose: close })) })] }))] }), !collapsed && (_jsxs(_Fragment, { children: [_jsx("div", { style: { padding: '4px 4px', borderBottom: `1px solid ${colors.borderLight}` }, children: _jsx("input", { type: "text", placeholder: "Search nodes...", value: searchQuery, onChange: (e) => setSearchQuery(e.target.value), onClick: (e) => e.stopPropagation(), style: Object.assign(Object.assign({}, base.input), { padding: '4px 8px' }) }) }), _jsx("div", { style: tree.scroll, children: _jsx(TreeNode, { nodeId: rootId, depth: 0, rootId: rootId, visibleIds: visibleIds, collapsedIds: collapsedIds, dropTarget: dropTarget, selectedNodeId: selectedId, onToggleCollapse: toggleCollapse, onOpenContextMenu: openContextMenu, onDragStart: handleDragStart, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, onDragEnd: () => { setDraggedId(null); setDropTarget(null); }, renderTreeNodeMenu: renderTreeNodeMenu, onToggleDisabled: handleToggleDisabled, setSelectedId: setSelectedId }) })] }))] }), _jsx(TreeContextMenu, { contextMenu: contextMenu, onClose: closeContextMenu, children: (nodeId, close) => renderTreeNodeMenu(nodeId, nodeId === rootId, close) })] }));
 }
 const TreeNode = memo(function TreeNode({ nodeId, depth, rootId, visibleIds, collapsedIds, dropTarget, selectedNodeId, onToggleCollapse, onOpenContextMenu, onDragStart, onDragOver, onDragLeave, onDrop, onDragEnd, renderTreeNodeMenu, onToggleDisabled, setSelectedId, }) {
     var _a;

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

@@ -20,9 +20,10 @@ export declare function TreeContextMenu({ contextMenu, onClose, children, }: {
     onClose: () => void;
     children: (nodeId: string, onClose: () => void) => React.ReactNode;
 }): import("react").ReactPortal | null;
-export declare function FileMenu({ getPrefab, onReplacePrefab, onImportPrefab, onClose }: {
+export declare function FileMenu({ getPrefab, onReplacePrefab, onImportPrefab, onImportPackedPrefab, onClose }: {
     getPrefab: () => Prefab;
     onReplacePrefab: (prefab: Prefab) => void;
     onImportPrefab: (prefab: Prefab) => void;
+    onImportPackedPrefab: (url: string) => void;
     onClose: () => void;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/tools/prefabeditor/EditorTreeMenus.js

@@ -13,7 +13,7 @@ import { createPortal } from 'react-dom';
 import { createEmptyPrefab } from './prefab';
 import { menu } from './styles';
 import { useEditorContext } from './PrefabEditor';
-import { loadJson, saveJson } from './utils';
+import { loadJson, loadJsonFile, saveJson, withBasePath } from './utils';
 function MenuPanel({ children, style, }) {
     return (_jsx("div", { style: Object.assign(Object.assign(Object.assign({}, menu.container), { position: 'static' }), style), onClick: (e) => e.stopPropagation(), children: children }));
 }
@@ -80,8 +80,8 @@ export function TreeContextMenu({ contextMenu, onClose, children, }) {
             zIndex: 1000,
         }, onMouseLeave: onClose, onContextMenu: (e) => e.preventDefault(), children: children(contextMenu.nodeId, onClose) }), document.body);
 }
-export function FileMenu({ getPrefab, onReplacePrefab, onImportPrefab, onClose }) {
-    const { onScreenshot, onExportGLB } = useEditorContext();
+export function FileMenu({ getPrefab, onReplacePrefab, onImportPrefab, onImportPackedPrefab, onClose }) {
+    const { basePath, onScreenshot, onExportGLB } = useEditorContext();
     const handleNew = () => {
         onReplacePrefab(createEmptyPrefab());
         onClose();
@@ -98,10 +98,22 @@ export function FileMenu({ getPrefab, onReplacePrefab, onImportPrefab, onClose }
         onClose();
     };
     const handleImport = () => __awaiter(this, void 0, void 0, function* () {
-        const loaded = yield loadJson();
+        const loaded = yield loadJsonFile();
         if (!loaded)
             return;
-        onImportPrefab(loaded);
+        try {
+            const manifest = yield fetch(withBasePath(basePath, '/prefabs/manifest.json')).then(r => r.json());
+            const matched = manifest.find(entry => entry.endsWith(`/${loaded.filename}`) || entry === `/${loaded.filename}`);
+            if (matched) {
+                onImportPackedPrefab(matched);
+                onClose();
+                return;
+            }
+        }
+        catch (_a) {
+            // manifest not available, fall through to full import
+        }
+        onImportPrefab(loaded.prefab);
         onClose();
     });
     return (_jsxs(MenuPanel, { style: { overflow: 'visible' }, children: [_jsxs(MenuSubmenu, { label: "File", children: [_jsx(MenuItemButton, { onClick: handleNew, children: "New Prefab" }), _jsx(MenuItemButton, { onClick: handleOpen, children: "Open Prefab" }), _jsx(MenuItemButton, { onClick: handleImport, children: "Import Prefab" }), _jsx(MenuItemButton, { onClick: handleSave, children: "Save Prefab" })] }), _jsxs(MenuSubmenu, { label: "Export", children: [_jsx(MenuItemButton, { onClick: () => { onExportGLB === null || onExportGLB === void 0 ? void 0 : onExportGLB(); onClose(); }, children: "GLB" }), _jsx(MenuItemButton, { onClick: () => { onScreenshot === null || onScreenshot === void 0 ? void 0 : onScreenshot(); onClose(); }, children: "PNG" })] })] }));

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

@@ -6,6 +6,7 @@ export type ContactEventPayload = {
     targetEntityId?: string | null;
     targetNodeId?: string | null;
     targetObject?: unknown;
+    collisionNormal?: [number, number, number];
     event?: unknown;
 };
 export type ClickEventPayload = {

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

@@ -2,7 +2,7 @@ import GameCanvas from "../../shared/GameCanvas";
 import type { Prefab } from "./types";
 import { PrefabEditorMode, type Scene } from "./PrefabRoot";
 import type { ExportGLBOptions } from "./utils";
-export declare function isAbsoluteAssetPath(path: string): boolean;
+export { isExternalPath as isAbsoluteAssetPath } from "./utils";
 export declare function resolvePrefabAssetPath(basePath: string, file: string): string;
 export declare function getPrefabAssetRef(assetRef: string, folder: "models" | "textures" | "sound"): string;
 export interface PrefabEditorRef extends Scene {
@@ -21,6 +21,7 @@ export interface PrefabEditorRef extends Scene {
 export type { PrefabNode } from "./PrefabRoot";
 export interface EditorContextType {
     mode: PrefabEditorMode;
+    basePath: string;
     setMode: (mode: PrefabEditorMode) => void;
     transformMode: "translate" | "rotate" | "scale";
     setTransformMode: (mode: "translate" | "rotate" | "scale") => void;

package/dist/tools/prefabeditor/PrefabEditor.js

@@ -16,10 +16,11 @@ import { findComponentEntry } from "./types";
 import { PrefabEditorMode, PrefabRoot } from "./PrefabRoot";
 import EditorUI from "./EditorUI";
 import { base, toolbar } from "./styles";
-import { computeParentWorldMatrix, decompose, exportGLB as exportGLBFile, exportGLBData, focusCameraOnObject, regenerateIds } from "./utils";
+import { computeParentWorldMatrix, decompose, exportGLB as exportGLBFile, exportGLBData, focusCameraOnObject, isExternalPath, regenerateIds, withBasePath } from "./utils";
 import { loadDroppedAssets } from "../dragdrop";
 import { denormalizePrefab, createImageNode, createModelNode, createNode } from './prefab';
 import { createPrefabStore, PrefabStoreProvider } from "./prefabStore";
+import { decomposeModelToPrefabNodes, hasCollisionMeshConventions } from "./modelPrefab";
 function isObjectAttachedToRoot(root, object) {
     if (!root || !object)
         return false;
@@ -31,18 +32,12 @@ function isObjectAttachedToRoot(root, object) {
     }
     return false;
 }
-export function isAbsoluteAssetPath(path) {
-    return (path.startsWith("data:") ||
-        path.startsWith("http://") ||
-        path.startsWith("https://"));
-}
+export { isExternalPath as isAbsoluteAssetPath } from "./utils";
 export function resolvePrefabAssetPath(basePath, file) {
-    if (isAbsoluteAssetPath(file))
-        return file;
-    return file.startsWith("/") ? `${basePath}${file}` : `${basePath}/${file}`;
+    return withBasePath(basePath, file);
 }
 export function getPrefabAssetRef(assetRef, folder) {
-    return isAbsoluteAssetPath(assetRef) ? assetRef : `${folder}/${assetRef}`;
+    return isExternalPath(assetRef) ? assetRef : `${folder}/${assetRef}`;
 }
 function SelectionHelper({ object }) {
     const objectRef = useRef(null);
@@ -76,7 +71,7 @@ const DEFAULT_PREFAB = {
     name: "New Prefab",
     root: createNode('Root', {}, { id: 'root' })
 };
-const PrefabEditor = forwardRef(({ basePath, initialPrefab, mode: initialMode = PrefabEditorMode.Edit, onChange, showUI = true, enableWindowDrop = true, canvasProps, uiPlugins, children }, ref) => {
+const PrefabEditor = forwardRef(({ basePath = "", initialPrefab, mode: initialMode = PrefabEditorMode.Edit, onChange, showUI = true, enableWindowDrop = true, canvasProps, uiPlugins, children }, ref) => {
     const [mode, setMode] = useState(initialMode);
     const [selectedId, setSelectedId] = useState(null);
     const [transformMode, setTransformMode] = useState("translate");
@@ -344,7 +339,23 @@ const PrefabEditor = forwardRef(({ basePath, initialPrefab, mode: initialMode =
                 onModelLoaded: (model, filename, file) => {
                     const path = getPrefabAssetRef(filename, 'models');
                     scene === null || scene === void 0 ? void 0 : scene.addModel(path, model);
-                    add(createModelNode(path, file.name.replace(/\.[^.]+$/, '')));
+                    const modelName = file.name.replace(/\.[^.]+$/, '');
+                    const modelIdPrefix = modelName.replace(/[^\w-]+/g, '-') || 'model';
+                    if (hasCollisionMeshConventions(model)) {
+                        const textureRefs = new Map();
+                        const decomposed = decomposeModelToPrefabNodes(model, {
+                            idPrefix: modelIdPrefix,
+                            getTexturePath: (texture, usage) => {
+                                const key = `embedded/${modelIdPrefix}/${usage}/${texture.uuid}`;
+                                textureRefs.set(key, texture);
+                                return key;
+                            },
+                        });
+                        textureRefs.forEach((texture, path) => scene === null || scene === void 0 ? void 0 : scene.addTexture(path, texture));
+                        add(Object.assign(Object.assign({}, decomposed), { name: modelName || decomposed.name }));
+                        return;
+                    }
+                    add(createModelNode(path, modelName));
                 },
                 onTextureLoaded: (texture, filename, file) => {
                     const path = getPrefabAssetRef(filename, 'textures');
@@ -368,6 +379,7 @@ const PrefabEditor = forwardRef(({ basePath, initialPrefab, mode: initialMode =
             return getRoot();
         },
         mode,
+        basePath,
         get: getNode,
         getObject,
         getHandle,
@@ -382,7 +394,7 @@ const PrefabEditor = forwardRef(({ basePath, initialPrefab, mode: initialMode =
         addModel: (path, model) => { var _a; return (_a = prefabRootRef.current) === null || _a === void 0 ? void 0 : _a.addModel(path, model); },
         addTexture: (path, texture) => { var _a; return (_a = prefabRootRef.current) === null || _a === void 0 ? void 0 : _a.addTexture(path, texture); },
         addSound: (path, sound) => { var _a; return (_a = prefabRootRef.current) === null || _a === void 0 ? void 0 : _a.addSound(path, sound); },
-    }), [add, duplicate, getHandle, getModel, getNode, getObject, getRoot, mode, move, remove, replace, replaceNode, update]);
+    }), [add, basePath, duplicate, getHandle, getModel, getNode, getObject, getRoot, mode, move, remove, replace, replaceNode, update]);
     const editorRefValue = useMemo(() => (Object.assign(Object.assign({}, sceneValue), { save: getPrefab, load: loadPrefab, undo,
         redo, screenshot: handleScreenshot, exportGLB: handleExportGLB, exportGLBData: handleExportGLBData, clearSelection })), [clearSelection, getPrefab, handleExportGLB, handleExportGLBData, handleScreenshot, loadPrefab, redo, sceneValue, undo]);
     useImperativeHandle(ref, () => editorRefValue, [editorRefValue]);
@@ -394,6 +406,7 @@ const PrefabEditor = forwardRef(({ basePath, initialPrefab, mode: initialMode =
     }, [canvasProps]);
     return _jsx(PrefabStoreProvider, { store: prefabStore, children: _jsx(EditorRefContext.Provider, { value: editorRefValue, children: _jsxs(EditorContext.Provider, { value: {
                     mode,
+                    basePath,
                     setMode: updateMode,
                     transformMode,
                     setTransformMode,

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

@@ -1,6 +1,6 @@
 import { Matrix4 } from "three";
 import type { Object3D, Texture } from "three";
-import type { ThreeEvent } from "@react-three/fiber";
+import { type ThreeEvent } from "@react-three/fiber";
 import type { GameObject as GameObjectType, Prefab } from "./types";
 import type { LoadedModels } from "../dragdrop";
 import type { PrefabStoreApi } from "./prefabStore";
@@ -12,6 +12,7 @@ export type PrefabNode = Omit<GameObjectType, "children">;
 export interface Scene {
     root: Object3D | null;
     mode: PrefabEditorMode;
+    basePath: string;
     get(id: string): GameObjectType | null;
     getObject(id: string): Object3D | null;
     getHandle<T = unknown>(id: string, kind: string): T | null;
@@ -53,5 +54,6 @@ interface RendererProps {
     editMode?: boolean;
     parentMatrix?: Matrix4;
     isVisible?: boolean;
+    basePath?: string;
 }
 export default PrefabRoot;

package/dist/tools/prefabeditor/PrefabRoot.js

@@ -1,3 +1,12 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __rest = (this && this.__rest) || function (s, e) {
     var t = {};
     for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
@@ -12,6 +21,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { createContext, forwardRef, useCallback, useContext, useEffect, useImperativeHandle, useMemo, useRef, useState } from "react";
 import { Euler, Matrix4 } from "three";
+import { useThree } from "@react-three/fiber";
 import { useStore } from "zustand";
 import { useClickValid } from "./useClickValid";
 import { findComponent, getNodeUserData } from "./types";
@@ -19,7 +29,7 @@ import { getComponentDef, registerComponent } from "./components/ComponentRegist
 import { builtinComponents } from "./components";
 import { loadModel, loadSound, loadTexture } from "../dragdrop";
 import { GameInstance, GameInstanceProvider, getRepeatAxesFromModelProperties } from "./InstanceProvider";
-import { composeTransform, decompose } from "./utils";
+import { composeTransform, decompose, withBasePath } from "./utils";
 import { createPrefabStore, PrefabStoreProvider, usePrefabChildIds, usePrefabNode, usePrefabRootId } from "./prefabStore";
 import { AssetRuntimeContext, NodeScope } from "./assetRuntime";
 import { gameEvents } from "./GameEvents";
@@ -37,13 +47,19 @@ const EMPTY_NODE_COMPONENTS = {
     clickEventName: null,
     composition: [],
 };
-/** Resolve a relative or absolute asset file path against a base path. */
-function resolveAssetPath(basePath, file) {
-    if (file.startsWith("data:"))
-        return file;
-    if (file.startsWith("http://") || file.startsWith("https://"))
-        return file;
-    return file.startsWith("/") ? `${basePath}${file}` : `${basePath}/${file}`;
+function precompileModel(model, renderer, camera) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            if (typeof renderer.compileAsync === "function") {
+                yield renderer.compileAsync(model, camera);
+                return;
+            }
+            renderer.compile(model, camera);
+        }
+        catch (error) {
+            console.warn("Failed to precompile model before adding it to the scene", error);
+        }
+    });
 }
 /** Check if a model component's assets are loaded. */
 function isNodeReady(model, loadedModels) {
@@ -74,6 +90,8 @@ export function useScene() {
     return scene;
 }
 export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSelect, onClick, onEditNodeClick, basePath = "", children }, ref) => {
+    const renderer = useThree(state => state.gl);
+    const camera = useThree(state => state.camera);
     const [models, setModels] = useState({});
     const [textures, setTextures] = useState({});
     const [sounds, setSounds] = useState({});
@@ -84,6 +102,7 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
     const failedModels = useRef(new Set());
     const failedTextures = useRef(new Set());
     const failedSounds = useRef(new Set());
+    const injectedModelVersions = useRef({});
     const objectRefs = useRef({});
     const nodeHandles = useRef(new Map());
     const [ownedStore] = useState(() => {
@@ -140,6 +159,7 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
             return (_a = objectRefs.current[rootId]) !== null && _a !== void 0 ? _a : null;
         },
         mode: editMode ? PrefabEditorMode.Edit : PrefabEditorMode.Play,
+        basePath,
         get: getNode,
         getObject,
         getHandle,
@@ -155,13 +175,22 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
         duplicate: (id) => resolvedStore.getState().duplicateNode(id),
         move: (draggedId, targetId, position) => resolvedStore.getState().moveNode(draggedId, targetId, position),
         replace: (prefab) => resolvedStore.getState().replacePrefab(prefab),
-        addModel: (path, model) => setInjectedModels(prev => (Object.assign(Object.assign({}, prev), { [path]: model }))),
+        addModel: (path, model) => {
+            var _a;
+            const version = ((_a = injectedModelVersions.current[path]) !== null && _a !== void 0 ? _a : 0) + 1;
+            injectedModelVersions.current[path] = version;
+            void precompileModel(model, renderer, camera).then(() => {
+                if (injectedModelVersions.current[path] !== version)
+                    return;
+                setInjectedModels(prev => (Object.assign(Object.assign({}, prev), { [path]: model })));
+            });
+        },
         addTexture: (path, texture) => setInjectedTextures(prev => (Object.assign(Object.assign({}, prev), { [path]: texture }))),
         addSound: (path, sound) => {
             soundManager.setBuffer(path, sound);
             setInjectedSounds(prev => (Object.assign(Object.assign({}, prev), { [path]: sound })));
         },
-    }), [editMode, getHandle, getModel, getNode, getObject, resolvedStore, rootId]);
+    }), [basePath, camera, editMode, getHandle, getModel, getNode, getObject, renderer, resolvedStore, rootId]);
     useImperativeHandle(ref, () => sceneValue, [sceneValue]);
     const registerRef = useCallback((id, obj) => {
         objectRefs.current[id] = obj;
@@ -176,7 +205,7 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
             if (loaded[file] || injected[file] || loading.current.has(file) || failed.has(file))
                 return;
             loading.current.add(file);
-            void loader(resolveAssetPath(basePath, file)).then(result => {
+            void loader(withBasePath(basePath, file)).then(result => {
                 loading.current.delete(file);
                 if (!result.success) {
                     console.warn(`Failed to load asset: ${file}`, result.error);
@@ -189,13 +218,14 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
             const type = entry.slice(0, separator);
             const file = entry.slice(separator + 1);
             if (type === 'model') {
-                loadAsset(file, models, injectedModels, failedModels.current, path => loadModel(path).then(result => {
+                loadAsset(file, models, injectedModels, failedModels.current, path => loadModel(path).then((result) => __awaiter(void 0, void 0, void 0, function* () {
                     const loadedModel = result.model;
                     if (result.success && loadedModel) {
+                        yield precompileModel(loadedModel, renderer, camera);
                         setModels(currentModels => (Object.assign(Object.assign({}, currentModels), { [file]: loadedModel })));
                     }
                     return result;
-                }));
+                })));
             }
             else if (type === 'texture') {
                 loadAsset(file, textures, injectedTextures, failedTextures.current, path => loadTexture(path).then(result => {
@@ -217,7 +247,7 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
                 }));
             }
         });
-    }, [assetRefCounts, basePath, injectedModels, injectedSounds, injectedTextures, models, sounds, textures]);
+    }, [assetRefCounts, basePath, camera, injectedModels, injectedSounds, injectedTextures, models, renderer, sounds, textures]);
     const assetRuntime = useMemo(() => ({
         registerHandle,
         getHandle,
@@ -235,7 +265,7 @@ export const PrefabRoot = forwardRef(({ editMode, data, store, selectedId, onSel
         emitNodePointerEvent(clickEventName, event, nodeId, node, fallbackObject);
         onClick === null || onClick === void 0 ? void 0 : onClick(event, node);
     }, [onClick, resolvedStore]);
-    const content = (_jsxs(GameInstanceProvider, { models: availableModels, selectedId: selectedId, editMode: editMode, onSelect: editMode ? onSelect : undefined, onClick: editMode ? undefined : handleNodeClick, registerRef: registerRef, children: [_jsx(StoreRootNode, { selectedId: selectedId, onSelect: editMode ? onSelect : undefined, onClick: editMode ? undefined : handleNodeClick, onEditNodeClick: editMode ? onEditNodeClick : undefined, registerRef: registerRef, loadedModels: availableModels, editMode: editMode, parentMatrix: IDENTITY }), children] }));
+    const content = (_jsxs(GameInstanceProvider, { models: availableModels, selectedId: selectedId, editMode: editMode, onSelect: editMode ? onSelect : undefined, onClick: editMode ? undefined : handleNodeClick, registerRef: registerRef, children: [_jsx(StoreRootNode, { selectedId: selectedId, onSelect: editMode ? onSelect : undefined, onClick: editMode ? undefined : handleNodeClick, onEditNodeClick: editMode ? onEditNodeClick : undefined, registerRef: registerRef, loadedModels: availableModels, editMode: editMode, parentMatrix: IDENTITY, basePath: basePath }), children] }));
     const runtimeContent = (_jsx(SceneContext.Provider, { value: sceneValue, children: _jsx(AssetRuntimeContext.Provider, { value: assetRuntime, children: content }) }));
     return _jsx(PrefabStoreProvider, { store: resolvedStore, children: runtimeContent });
 });
@@ -303,10 +333,7 @@ function analyzeNodeComponents(node) {
 }
 function emitNodePointerEvent(eventName, event, nodeId, node, fallbackObject) {
     var _a;
-    const trimmedEventName = eventName === null || eventName === void 0 ? void 0 : eventName.trim();
-    if (!trimmedEventName)
-        return;
-    gameEvents.emit(trimmedEventName, {
+    const payload = {
         sourceEntityId: nodeId,
         sourceNodeId: nodeId,
         nodeId,
@@ -319,7 +346,12 @@ function emitNodePointerEvent(eventName, event, nodeId, node, fallbackObject) {
         metaKey: event.nativeEvent.metaKey,
         shiftKey: event.nativeEvent.shiftKey,
         r3fEvent: event,
-    });
+    };
+    gameEvents.emit('click', payload);
+    const trimmedEventName = eventName === null || eventName === void 0 ? void 0 : eventName.trim();
+    if (!trimmedEventName)
+        return;
+    gameEvents.emit(trimmedEventName, payload);
 }
 export function GameObjectRenderer(props) {
     var _a, _b;
@@ -374,7 +406,7 @@ function InstancedNode({ nodeId, parentMatrix = IDENTITY, editMode, registerRef,
     }
     return _jsx(_Fragment, { children: renderedInstances });
 }
-function StandardNode({ nodeId, selectedId, onSelect, onClick, onEditNodeClick, registerRef, loadedModels, editMode, parentMatrix = IDENTITY, isVisible = true, }) {
+function StandardNode({ nodeId, selectedId, onSelect, onClick, onEditNodeClick, registerRef, loadedModels, editMode, parentMatrix = IDENTITY, isVisible = true, basePath = "", }) {
     const gameObject = usePrefabNode(nodeId);
     const childIds = usePrefabChildIds(nodeId);
     const analyzedComponents = useMemo(() => gameObject ? analyzeNodeComponents(gameObject) : EMPTY_NODE_COMPONENTS, [gameObject]);
@@ -410,9 +442,13 @@ function StandardNode({ nodeId, selectedId, onSelect, onClick, onEditNodeClick,
         rotation: transform.rotation,
         scale: transform.scale,
     };
+    const worldTransform = decompose(world);
     const groupProps = Object.assign(Object.assign({}, metadataProps), transformProps);
-    const childNodes = _jsx(ChildNodes, { childIds: childIds, parentMatrix: world, selectedId: selectedId, onSelect: onSelect, onClick: onClick, onEditNodeClick: onEditNodeClick, registerRef: registerRef, loadedModels: loadedModels, editMode: editMode, isVisible: nodeVisible });
-    const inner = renderNodeContent(analyzedComponents, loadedModels, primaryClickHandlers, childNodes);
+    const childNodes = _jsx(ChildNodes, { childIds: childIds, parentMatrix: world, selectedId: selectedId, onSelect: onSelect, onClick: onClick, onEditNodeClick: onEditNodeClick, registerRef: registerRef, loadedModels: loadedModels, editMode: editMode, isVisible: nodeVisible, basePath: basePath });
+    const nodeInteractionHandlers = editMode ? editClickHandlers : primaryClickHandlers;
+    const componentRuntimeProps = Object.assign(Object.assign({ editMode,
+        nodeInteractionHandlers }, transformProps), { worldPosition: worldTransform.position });
+    const inner = renderNodeContent(analyzedComponents, loadedModels, primaryClickHandlers, childNodes, basePath, componentRuntimeProps);
     const editAnchor = editMode ? (_jsx("mesh", { visible: false, children: _jsx("boxGeometry", { args: [0.01, 0.01, 0.01] }) })) : null;
     const standardNode = (_jsxs("group", Object.assign({ ref: handleGroupRef }, groupProps, { visible: nodeVisible }, (editMode ? editClickHandlers : undefined), { children: [editAnchor, inner] })));
     return (_jsx(NodeScope, { nodeId: nodeId, editMode: editMode, isSelected: isSelected, children: standardNode }));
@@ -485,7 +521,7 @@ function getNodeTransformProps(node) {
         scale: (_d = t === null || t === void 0 ? void 0 : t.scale) !== null && _d !== void 0 ? _d : [1, 1, 1],
     };
 }
-function renderNodeContent(analyzedComponents, loadedModels, primaryClickHandlers, childNodes) {
+function renderNodeContent(analyzedComponents, loadedModels, primaryClickHandlers, childNodes, basePath = "", componentRuntimeProps) {
     var _a, _b, _c, _d, _e, _f;
     const geometry = analyzedComponents.geometry;
     const models = analyzedComponents.models;
@@ -550,7 +586,7 @@ function renderNodeContent(analyzedComponents, loadedModels, primaryClickHandler
     }
     let content = _jsxs(_Fragment, { children: [primaryContent, contentChildren] });
     for (const { key, View, properties } of analyzedComponents.composition) {
-        content = (_jsx(View, { properties: properties, children: content }, key));
+        content = (_jsx(View, Object.assign({ properties: properties, basePath: basePath }, componentRuntimeProps, { children: content }), key));
     }
     return content;
 }

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

@@ -1,4 +1,5 @@
 import type { FC } from "react";
+import type { ThreeEvent } from "@react-three/fiber";
 import type { ComponentData, GameObject } from "../types";
 export type AssetRef = {
     type: "model" | "texture" | "sound";
@@ -12,13 +13,27 @@ export interface ComponentViewProps<P = Record<string, unknown>> {
     properties: P;
     /** Children to render for components that wrap the current subtree. */
     children?: React.ReactNode;
+    /** Whether this node is currently rendered in editor mode. */
+    editMode?: boolean;
+    /** Node-level pointer/click handlers for custom components that render their own pickable objects. */
+    nodeInteractionHandlers?: NodeInteractionHandlers;
     /** Current node local position for wrapper components. */
     position?: [number, number, number];
     /** Current node local rotation in radians for wrapper components. */
     rotation?: [number, number, number];
     /** Current node local scale for wrapper components. */
     scale?: [number, number, number];
+    /** Current node world position. Components that create world-space resources should prefer this. */
+    worldPosition?: [number, number, number];
+    /** Public asset URL prefix, such as a Next.js basePath. */
+    basePath?: string;
 }
+export type NodeInteractionHandlers = {
+    onClick?: (event: ThreeEvent<PointerEvent>) => void;
+    onPointerDown?: (event: ThreeEvent<PointerEvent>) => void;
+    onPointerMove?: (event: ThreeEvent<PointerEvent>) => void;
+    onPointerUp?: (event: ThreeEvent<PointerEvent>) => void;
+};
 export interface Component {
     name: string;
     /** Set when this component occupies a single slot on a node. Use a string to share a slot across component types. */

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

@@ -0,0 +1,3 @@
+import type { Component } from './ComponentRegistry';
+declare const PrefabRefComponent: Component;
+export default PrefabRefComponent;