react-three-game 0.0.67 → 0.0.69

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

@@ -2,57 +2,36 @@ import { GameObject, Prefab } from "./types";
 import { Matrix4, Object3D, Vector3 } from 'three';
 export interface ExportGLBOptions {
     filename?: string;
-    binary?: boolean;
-    onComplete?: (result: ArrayBuffer | object) => void;
-    onError?: (error: any) => void;
 }
-/** Save a prefab as JSON file, showing a Save As dialog when supported */
+/** Save scene JSON, showing a Save As dialog when supported */
 export declare function saveJson(data: Prefab, filename: string): Promise<void>;
-/** Load a prefab from JSON file */
+/** Load scene JSON from a file */
 export declare function loadJson(): Promise<Prefab | undefined>;
 /**
- * Export a Three.js scene or object to GLB format
- * @param sceneRoot - The Three.js Object3D to export
- * @param options - Export options
- * @returns Promise that resolves when export is complete
+ * Export a Three.js scene or object to GLB binary data
  */
-export declare function exportGLB(sceneRoot: Object3D, options?: ExportGLBOptions): Promise<ArrayBuffer | object>;
+export declare function exportGLBData(sceneRoot: Object3D): Promise<ArrayBuffer>;
 /**
- * Export a Three.js scene to GLB and return the ArrayBuffer without downloading
- * @param sceneRoot - The Three.js Object3D to export
- * @returns Promise that resolves with the GLB data as ArrayBuffer
+ * Export a Three.js scene or object to GLB and trigger a download
  */
-export declare function exportGLBData(sceneRoot: Object3D): Promise<ArrayBuffer>;
+export declare function exportGLB(sceneRoot: Object3D, options?: ExportGLBOptions): Promise<ArrayBuffer>;
 export declare function focusCameraOnObject(object: Object3D, camera: Object3D, target: Vector3, update?: () => void): void;
 export declare function decompose(m: Matrix4): {
     position: [number, number, number];
     rotation: [number, number, number];
     scale: [number, number, number];
 };
-export declare function computeParentWorldMatrix(root: GameObject, targetId: string): Matrix4;
-/** Find a node by ID in the tree */
-export declare function findNode(root: GameObject, id: string): GameObject | null;
-/** Find the parent of a node by ID */
-export declare function findParent(root: GameObject, id: string): GameObject | null;
-/** Find all nodes matching a predicate */
-export declare function findAll(root: GameObject, predicate: (node: GameObject) => boolean): GameObject[];
-/** Find all nodes that have a specific component type */
-export declare function findByComponent(root: GameObject, componentType: string): GameObject[];
-/** Get a flattened list of all nodes */
-export declare function flatten(root: GameObject): GameObject[];
-/** Immutably update a node by ID */
-export declare function updateNode(root: GameObject, id: string, update: (node: GameObject) => GameObject): GameObject;
-/** Immutably insert a node under a parent ID, defaulting to the root when the parent is missing */
-export declare function insertNode(root: GameObject, node: GameObject, parentId?: string): GameObject;
-/** Immutably delete a node by ID */
-export declare function deleteNode(root: GameObject, id: string): GameObject | null;
-/** Deep clone a node with new IDs */
-export declare function cloneNode(node: GameObject): GameObject;
+/** Compute the parent world matrix for a node using the normalized store data */
+export declare function computeParentWorldMatrix(state: {
+    nodesById: Record<string, {
+        components?: Record<string, {
+            properties?: Record<string, any>;
+        } | undefined>;
+    }>;
+    parentIdById: Record<string, string | null>;
+}, targetId: string): Matrix4;
 /** Recursively update all IDs in a node tree */
 export declare function regenerateIds(node: GameObject): GameObject;
-/** Get component data from a node */
-export declare function getComponent<T = any>(node: GameObject, type: string): T | undefined;
-export declare function updateNodeById(root: GameObject, id: string, updater: (node: GameObject) => GameObject): GameObject;
 /** Create a GameObject node for a 3D model file */
 export declare function createModelNode(filename: string, name?: string): GameObject;
 /** Create a GameObject node for an image as a textured plane */

package/dist/tools/prefabeditor/utils.js

@@ -9,14 +9,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { GLTFExporter } from 'three/examples/jsm/exporters/GLTFExporter.js';
 import { Box3, Euler, Matrix4, PerspectiveCamera, Quaternion, Vector3 } from 'three';
-/** Save a prefab as JSON file, showing a Save As dialog when supported */
+/** Save scene JSON, showing a Save As dialog when supported */
 export function saveJson(data, filename) {
     return __awaiter(this, void 0, void 0, function* () {
         const json = JSON.stringify(data, null, 2);
         if ('showSaveFilePicker' in window) {
             try {
                 const handle = yield window.showSaveFilePicker({
-                    suggestedName: `${filename || 'prefab'}.json`,
+                    suggestedName: `${filename || 'scene'}.json`,
                     types: [{ description: 'JSON', accept: { 'application/json': ['.json'] } }],
                 });
                 const writable = yield handle.createWritable();
@@ -32,11 +32,11 @@ export function saveJson(data, filename) {
         // Fallback for browsers without File System Access API
         const a = document.createElement('a');
         a.href = "data:text/json;charset=utf-8," + encodeURIComponent(json);
-        a.download = `${filename || 'prefab'}.json`;
+        a.download = `${filename || 'scene'}.json`;
         a.click();
     });
 }
-/** Load a prefab from JSON file */
+/** Load scene JSON from a file */
 export function loadJson() {
     return new Promise(resolve => {
         const input = document.createElement('input');
@@ -56,7 +56,7 @@ export function loadJson() {
                         resolve(JSON.parse(text));
                 }
                 catch (err) {
-                    console.error('Error parsing prefab JSON:', err);
+                    console.error('Error parsing scene JSON:', err);
                     resolve(undefined);
                 }
             };
@@ -66,44 +66,30 @@ export function loadJson() {
     });
 }
 /**
- * Export a Three.js scene or object to GLB format
- * @param sceneRoot - The Three.js Object3D to export
- * @param options - Export options
- * @returns Promise that resolves when export is complete
+ * Export a Three.js scene or object to GLB binary data
  */
-export function exportGLB(sceneRoot, options = {}) {
-    const { filename = 'scene.glb', binary = true, onComplete, onError } = options;
+export function exportGLBData(sceneRoot) {
     return new Promise((resolve, reject) => {
-        const exporter = new GLTFExporter();
-        exporter.parse(sceneRoot, (result) => {
-            onComplete === null || onComplete === void 0 ? void 0 : onComplete(result);
-            resolve(result);
-            // Trigger download if filename is provided
-            if (filename) {
-                const blob = new Blob([result], { type: binary ? 'application/octet-stream' : 'application/json' });
-                const url = URL.createObjectURL(blob);
-                const a = document.createElement('a');
-                a.href = url;
-                a.download = filename;
-                a.click();
-                URL.revokeObjectURL(url);
-            }
-        }, (error) => {
-            console.error('Error exporting GLB:', error);
-            onError === null || onError === void 0 ? void 0 : onError(error);
-            reject(error);
-        }, { binary });
+        new GLTFExporter().parse(sceneRoot, (result) => resolve(result), (error) => reject(error), { binary: true });
     });
 }
 /**
- * Export a Three.js scene to GLB and return the ArrayBuffer without downloading
- * @param sceneRoot - The Three.js Object3D to export
- * @returns Promise that resolves with the GLB data as ArrayBuffer
+ * Export a Three.js scene or object to GLB and trigger a download
  */
-export function exportGLBData(sceneRoot) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const result = yield exportGLB(sceneRoot, { filename: '', binary: true });
-        return result;
+export function exportGLB(sceneRoot_1) {
+    return __awaiter(this, arguments, void 0, function* (sceneRoot, options = {}) {
+        const { filename = 'scene.glb' } = options;
+        const data = yield exportGLBData(sceneRoot);
+        if (filename) {
+            const blob = new Blob([data], { type: 'application/octet-stream' });
+            const url = URL.createObjectURL(blob);
+            const a = document.createElement('a');
+            a.href = url;
+            a.download = filename;
+            a.click();
+            URL.revokeObjectURL(url);
+        }
+        return data;
     });
 }
 export function focusCameraOnObject(object, camera, target, update) {
@@ -143,139 +129,27 @@ export function decompose(m) {
         scale: [s.x, s.y, s.z],
     };
 }
-function compose(node) {
-    var _a, _b, _c, _d, _e;
-    const t = (_b = (_a = node === null || node === void 0 ? void 0 : node.components) === null || _a === void 0 ? void 0 : _a.transform) === null || _b === void 0 ? void 0 : _b.properties;
-    const position = (_c = t === null || t === void 0 ? void 0 : t.position) !== null && _c !== void 0 ? _c : [0, 0, 0];
-    const rotation = (_d = t === null || t === void 0 ? void 0 : t.rotation) !== null && _d !== void 0 ? _d : [0, 0, 0];
-    const scale = (_e = t === null || t === void 0 ? void 0 : t.scale) !== null && _e !== void 0 ? _e : [1, 1, 1];
-    return new Matrix4().compose(new Vector3(...position), new Quaternion().setFromEuler(new Euler(...rotation)), new Vector3(...scale));
-}
-export function computeParentWorldMatrix(root, targetId) {
-    const identity = new Matrix4();
-    let result = null;
-    const visit = (node, parent) => {
-        var _a;
-        if (node.id === targetId) {
-            result = parent.clone();
-            return;
-        }
-        const world = parent.clone().multiply(compose(node));
-        (_a = node.children) === null || _a === void 0 ? void 0 : _a.forEach(child => !result && visit(child, world));
-    };
-    visit(root, identity);
-    return result !== null && result !== void 0 ? result : identity;
-}
-/** Find a node by ID in the tree */
-export function findNode(root, id) {
-    var _a;
-    if (root.id === id)
-        return root;
-    for (const child of (_a = root.children) !== null && _a !== void 0 ? _a : []) {
-        const found = findNode(child, id);
-        if (found)
-            return found;
-    }
-    return null;
-}
-/** Find the parent of a node by ID */
-export function findParent(root, id) {
-    var _a;
-    for (const child of (_a = root.children) !== null && _a !== void 0 ? _a : []) {
-        if (child.id === id)
-            return root;
-        const found = findParent(child, id);
-        if (found)
-            return found;
-    }
-    return null;
-}
-/** Find all nodes matching a predicate */
-export function findAll(root, predicate) {
-    var _a;
-    const results = [];
-    if (predicate(root))
-        results.push(root);
-    for (const child of (_a = root.children) !== null && _a !== void 0 ? _a : []) {
-        results.push(...findAll(child, predicate));
-    }
-    return results;
-}
-/** Find all nodes that have a specific component type */
-export function findByComponent(root, componentType) {
-    return findAll(root, node => { var _a; return Object.values((_a = node.components) !== null && _a !== void 0 ? _a : {}).some(c => (c === null || c === void 0 ? void 0 : c.type) === componentType); });
-}
-/** Get a flattened list of all nodes */
-export function flatten(root) {
-    return findAll(root, () => true);
-}
-/** Immutably update a node by ID */
-export function updateNode(root, id, update) {
-    if (root.id === id)
-        return update(root);
-    if (!root.children)
-        return root;
-    return Object.assign(Object.assign({}, root), { children: root.children.map(child => updateNode(child, id, update)) });
-}
-/** Immutably insert a node under a parent ID, defaulting to the root when the parent is missing */
-export function insertNode(root, node, parentId) {
-    var _a, _b;
-    if (!parentId || parentId === root.id) {
-        return Object.assign(Object.assign({}, root), { children: [...((_a = root.children) !== null && _a !== void 0 ? _a : []), node] });
+/** Compute the parent world matrix for a node using the normalized store data */
+export function computeParentWorldMatrix(state, targetId) {
+    var _a, _b, _c, _d, _e, _f;
+    const parentWorld = new Matrix4();
+    const chain = [];
+    let currentId = state.parentIdById[targetId];
+    while (currentId) {
+        chain.unshift(currentId);
+        currentId = state.parentIdById[currentId];
     }
-    const nextRoot = updateNode(root, parentId, parent => {
-        var _a;
-        return (Object.assign(Object.assign({}, parent), { children: [...((_a = parent.children) !== null && _a !== void 0 ? _a : []), node] }));
-    });
-    if (nextRoot === root) {
-        return Object.assign(Object.assign({}, root), { children: [...((_b = root.children) !== null && _b !== void 0 ? _b : []), node] });
+    for (const nodeId of chain) {
+        const transform = (_c = (_b = (_a = state.nodesById[nodeId]) === null || _a === void 0 ? void 0 : _a.components) === null || _b === void 0 ? void 0 : _b.transform) === null || _c === void 0 ? void 0 : _c.properties;
+        parentWorld.multiply(new Matrix4().compose(new Vector3(...((_d = transform === null || transform === void 0 ? void 0 : transform.position) !== null && _d !== void 0 ? _d : [0, 0, 0])), new Quaternion().setFromEuler(new Euler(...((_e = transform === null || transform === void 0 ? void 0 : transform.rotation) !== null && _e !== void 0 ? _e : [0, 0, 0]))), new Vector3(...((_f = transform === null || transform === void 0 ? void 0 : transform.scale) !== null && _f !== void 0 ? _f : [1, 1, 1]))));
     }
-    return nextRoot;
-}
-/** Immutably delete a node by ID */
-export function deleteNode(root, id) {
-    if (root.id === id)
-        return null;
-    if (!root.children)
-        return root;
-    return Object.assign(Object.assign({}, root), { children: root.children
-            .map(child => deleteNode(child, id))
-            .filter((child) => child !== null) });
-}
-/** Deep clone a node with new IDs */
-export function cloneNode(node) {
-    var _a, _b;
-    return Object.assign(Object.assign({}, node), { id: crypto.randomUUID(), name: `${(_a = node.name) !== null && _a !== void 0 ? _a : node.id} Copy`, children: (_b = node.children) === null || _b === void 0 ? void 0 : _b.map(cloneNode) });
+    return parentWorld;
 }
 /** Recursively update all IDs in a node tree */
 export function regenerateIds(node) {
     var _a;
     return Object.assign(Object.assign({}, node), { id: crypto.randomUUID(), children: (_a = node.children) === null || _a === void 0 ? void 0 : _a.map(regenerateIds) });
 }
-/** Get component data from a node */
-export function getComponent(node, type) {
-    var _a;
-    const comp = Object.values((_a = node.components) !== null && _a !== void 0 ? _a : {}).find(c => (c === null || c === void 0 ? void 0 : c.type) === type);
-    return comp === null || comp === void 0 ? void 0 : comp.properties;
-}
-export function updateNodeById(root, id, updater) {
-    if (root.id === id) {
-        return updater(root);
-    }
-    if (!root.children) {
-        return root;
-    }
-    let didChange = false;
-    const newChildren = root.children.map(child => {
-        const updated = updateNodeById(child, id, updater);
-        if (updated !== child)
-            didChange = true;
-        return updated;
-    });
-    if (!didChange)
-        return root;
-    return Object.assign(Object.assign({}, root), { children: newChildren });
-}
 /** Create a GameObject node for a 3D model file */
 export function createModelNode(filename, name) {
     return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-three-game",
-  "version": "0.0.67",
-  "description": "high performance 3D game engine for React",
+  "version": "0.0.69",
+  "description": "high performance 3D game engine built in React",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -48,6 +48,7 @@
     "vite": "^7.3.1"
   },
   "dependencies": {
-    "react-error-boundary": "^6.1.0"
+    "react-error-boundary": "^6.1.0",
+    "zustand": "^5.0.12"
   }
 }

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

@@ -1,7 +0,0 @@
-interface EventSystemRef {
-    fire: (eventType: string, data?: any) => void;
-}
-declare const EventSystemHook: import("react").ForwardRefExoticComponent<{
-    entityId: string;
-} & import("react").RefAttributes<EventSystemRef>>;
-export default EventSystemHook;

package/dist/tools/prefabeditor/EventSystem.js

@@ -1,23 +0,0 @@
-import { useRef, useImperativeHandle, forwardRef, useCallback } from 'react';
-const EventSystemHook = forwardRef(({ entityId }, ref) => {
-    const targetRef = useRef(typeof window !== 'undefined' ? window : null);
-    // Fire a global JS event with entityId as source
-    const fire = useCallback((eventType, data) => {
-        if (!targetRef.current)
-            return;
-        const event = new CustomEvent(eventType, {
-            detail: {
-                entityId,
-                data,
-            },
-        });
-        targetRef.current.dispatchEvent(event);
-    }, [entityId]);
-    // Expose ref API
-    useImperativeHandle(ref, () => ({
-        fire,
-    }), [fire]);
-    return null;
-});
-EventSystemHook.displayName = 'EventSystemHook';
-export default EventSystemHook;