react-three-game 0.0.81 → 0.0.83

package/dist/index.d.ts

@@ -26,10 +26,11 @@ export type { Component, ComponentViewProps } from './tools/prefabeditor/compone
 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 { gameEvents, useGameEvent, usePhysicsEvent, useClickEvent, getEntityIdFromRigidBody } from './tools/prefabeditor/GameEvents';
 export type { GameEventType, GameEventMap, GameEventPayload, PhysicsEventType, InteractionEventType, PhysicsEventPayload, ClickEventPayload } from './tools/prefabeditor/GameEvents';
 export { loadFiles } from './tools/dragdrop/DragDropLoader';
 export type { AssetLoadOptions } from './tools/dragdrop/DragDropLoader';
 export { loadModel, loadSound, loadTexture } from './tools/dragdrop/modelLoader';
 export type { LoadedModel, LoadedModels, ModelLoadResult, LoadedSound, LoadedSounds, SoundLoadResult, LoadedTexture, LoadedTextures, TextureLoadResult, ProgressCallback, } from './tools/dragdrop/modelLoader';
 export { ModelListViewer, SoundListViewer, ModelPicker, SoundPicker, TextureListViewer, TexturePicker, SingleModelViewer, SingleSoundViewer, SingleTextureViewer, SharedCanvas, } from './tools/assetviewer/page';
+export type { PrefabRootRef } from './tools/prefabeditor/PrefabRoot';

package/dist/index.js

@@ -22,7 +22,7 @@ export { createModelNode, createImageNode, } from './tools/prefabeditor/prefab';
 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';
+export { gameEvents, useGameEvent, usePhysicsEvent, useClickEvent, getEntityIdFromRigidBody } from './tools/prefabeditor/GameEvents';
 // Asset Loading
 export { loadFiles } from './tools/dragdrop/DragDropLoader';
 export { loadModel, loadSound, loadTexture } from './tools/dragdrop/modelLoader';

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

@@ -40,6 +40,13 @@ export type GameEventType = keyof GameEventMap | (string & {});
 /** Get payload type for an event, or fallback to generic */
 export type GameEventPayload<T extends string> = T extends keyof GameEventMap ? GameEventMap[T] : Record<string, unknown>;
 type EventHandler<T = unknown> = (payload: T) => void;
+type UnknownEventPayload = Record<string, unknown>;
+declare function emitGameEvent<TType extends keyof GameEventMap>(type: TType, payload: GameEventMap[TType]): void;
+declare function emitGameEvent(type: string, payload: UnknownEventPayload): void;
+declare function onGameEvent<TType extends keyof GameEventMap>(type: TType, handler: EventHandler<GameEventMap[TType]>): () => void;
+declare function onGameEvent(type: string, handler: EventHandler<UnknownEventPayload>): () => void;
+declare function offGameEvent<TType extends keyof GameEventMap>(type: TType, handler: EventHandler<GameEventMap[TType]>): void;
+declare function offGameEvent(type: string, handler: EventHandler<UnknownEventPayload>): void;
 /**
  * Game event system for all game interactions.
  *
@@ -66,16 +73,16 @@ export declare const gameEvents: {
     /**
      * Emit an event to all subscribers
      */
-    emit<T extends string>(type: T, payload: GameEventPayload<T>): void;
+    emit: typeof emitGameEvent;
     /**
      * Subscribe to an event type
      * @returns Unsubscribe function
      */
-    on<T extends string>(type: T, handler: EventHandler<GameEventPayload<T>>): () => void;
+    on: typeof onGameEvent;
     /**
      * Unsubscribe from an event type
      */
-    off<T extends string>(type: T, handler: EventHandler<GameEventPayload<T>>): void;
+    off: typeof offGameEvent;
     /**
      * Remove all subscribers (useful for cleanup/reset)
      */
@@ -97,10 +104,22 @@ export declare const gameEvents: {
  *
  * // Custom event
  * useGameEvent('player:death', (payload) => {
- *   showGameOver(payload.cause);
+ *   const cause = typeof payload.cause === 'string' ? payload.cause : 'unknown';
+ *   showGameOver(cause);
  * }, []);
  */
-export declare function useGameEvent<T extends string>(type: T, handler: EventHandler<GameEventPayload<T>>, deps?: unknown[]): void;
+export declare function useGameEvent<TType extends keyof GameEventMap>(type: TType, handler: EventHandler<GameEventMap[TType]>, deps?: unknown[]): void;
+export declare function useGameEvent(type: string, handler: EventHandler<UnknownEventPayload>, deps?: unknown[]): void;
+/**
+ * React hook to subscribe to any physics event payload.
+ * Use this when the event name is dynamic but the payload comes from PhysicsComponent.
+ */
+export declare function usePhysicsEvent(type: string, handler: EventHandler<PhysicsEventPayload>, deps?: unknown[]): void;
+/**
+ * React hook to subscribe to click event payloads.
+ * Use this when the event name is dynamic but the payload comes from ClickComponent.
+ */
+export declare function useClickEvent(type: string, handler: EventHandler<ClickEventPayload>, deps?: unknown[]): void;
 /**
  * Helper to extract entity ID from Rapier collision data.
  * Entity IDs are stored in RigidBody userData.

package/dist/tools/prefabeditor/GameEvents.js

@@ -1,6 +1,40 @@
 import { useEffect, useCallback } from 'react';
 // Internal subscriber storage
 const subscribers = new Map();
+function emitGameEvent(type, payload) {
+    const handlers = subscribers.get(type);
+    if (handlers) {
+        handlers.forEach(handler => {
+            try {
+                handler(payload);
+            }
+            catch (e) {
+                console.error(`Error in gameEvents handler for ${type}:`, e);
+            }
+        });
+    }
+}
+function onGameEvent(type, handler) {
+    if (!subscribers.has(type)) {
+        subscribers.set(type, new Set());
+    }
+    subscribers.get(type).add(handler);
+    return () => {
+        var _a;
+        (_a = subscribers.get(type)) === null || _a === void 0 ? void 0 : _a.delete(handler);
+    };
+}
+function offGameEvent(type, handler) {
+    var _a;
+    (_a = subscribers.get(type)) === null || _a === void 0 ? void 0 : _a.delete(handler);
+}
+function useTypedGameEvent(type, handler, deps = []) {
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const stableHandler = useCallback(handler, deps);
+    useEffect(() => {
+        return onGameEvent(type, stableHandler);
+    }, [type, stableHandler]);
+}
 /**
  * Game event system for all game interactions.
  *
@@ -27,40 +61,16 @@ export const gameEvents = {
     /**
      * Emit an event to all subscribers
      */
-    emit(type, payload) {
-        const handlers = subscribers.get(type);
-        if (handlers) {
-            handlers.forEach(handler => {
-                try {
-                    handler(payload);
-                }
-                catch (e) {
-                    console.error(`Error in gameEvents handler for ${type}:`, e);
-                }
-            });
-        }
-    },
+    emit: emitGameEvent,
     /**
      * Subscribe to an event type
      * @returns Unsubscribe function
      */
-    on(type, handler) {
-        if (!subscribers.has(type)) {
-            subscribers.set(type, new Set());
-        }
-        subscribers.get(type).add(handler);
-        return () => {
-            var _a;
-            (_a = subscribers.get(type)) === null || _a === void 0 ? void 0 : _a.delete(handler);
-        };
-    },
+    on: onGameEvent,
     /**
      * Unsubscribe from an event type
      */
-    off(type, handler) {
-        var _a;
-        (_a = subscribers.get(type)) === null || _a === void 0 ? void 0 : _a.delete(handler);
-    },
+    off: offGameEvent,
     /**
      * Remove all subscribers (useful for cleanup/reset)
      */
@@ -75,27 +85,22 @@ export const gameEvents = {
         return ((_b = (_a = subscribers.get(type)) === null || _a === void 0 ? void 0 : _a.size) !== null && _b !== void 0 ? _b : 0) > 0;
     }
 };
+export function useGameEvent(type, handler, deps = []) {
+    useTypedGameEvent(type, handler, deps);
+}
 /**
- * React hook to subscribe to game events.
- * Automatically cleans up on unmount.
- *
- * @example
- * // Physics event
- * useGameEvent('sensor:enter', (payload) => {
- *   if (payload.sourceEntityId === 'coin') collectCoin();
- * }, []);
- *
- * // Custom event
- * useGameEvent('player:death', (payload) => {
- *   showGameOver(payload.cause);
- * }, []);
+ * React hook to subscribe to any physics event payload.
+ * Use this when the event name is dynamic but the payload comes from PhysicsComponent.
  */
-export function useGameEvent(type, handler, deps = []) {
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    const stableHandler = useCallback(handler, deps);
-    useEffect(() => {
-        return gameEvents.on(type, stableHandler);
-    }, [type, stableHandler]);
+export function usePhysicsEvent(type, handler, deps = []) {
+    useTypedGameEvent(type, handler, deps);
+}
+/**
+ * React hook to subscribe to click event payloads.
+ * Use this when the event name is dynamic but the payload comes from ClickComponent.
+ */
+export function useClickEvent(type, handler, deps = []) {
+    useTypedGameEvent(type, handler, deps);
 }
 // ============================================================================
 // Helpers

package/package.json

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