@codexo/exojs-react 0.14.0 → 0.15.0

package/README.md

@@ -37,7 +37,7 @@ function Game() {
       options={{ canvas: { width: 1280, height: 720 }, clearColor: someColor }}
       style={{ width: 1280, height: 720 }}
     >
-      <Scenes active="game" transition={{ type: 'fade', duration: 0.3 }}>
+      <Scenes active="game" transition={{ type: 'fade', duration: 300 }}>
         <Scene name="title" component={TitleScene} />
         <Scene name="game" component={GameScene}>
           <Hud /> {/* absolutely-positioned React overlay, over the canvas */}
@@ -72,14 +72,15 @@ function Game() {
 
 | Export | Kind | Purpose |
 |---|---|---|
-| `ExoCanvas` | component | Batteries-included canvas host (wrapper div + canvas + context). |
-| `useExoApplication(options?, onReady?)` | hook | Headless: owns the `Application`, returns `{ app, canvasRef }`. |
+| `ExoCanvas` | component | Batteries-included canvas host (wrapper div + canvas + context). Accepts `onReady`/`onError`. |
+| `useExoApplication(options?, onReady?, onError?)` | hook | Headless: owns the `Application`, returns `{ app, canvasRef }`. `onError` mirrors `Application.onError`. |
 | `useExoApp()` | hook | The `Application` from the nearest `<ExoCanvas>`/provider. Throws if absent. |
 | `useExoContext()` | hook | Like `useExoApp` but returns `Application \| null` (no throw). |
 | `ExoContext` | context | The underlying context (advanced / testing). |
-| `useScene(SceneClass, deps?)` | hook | Instantiate + activate a single scene; returns it once live. |
-| `Scenes` / `Scene` | components | Declarative scene switch over the one-active-scene model. |
+| `useScene(SceneClass, deps?)` | hook | Instantiate + activate a single scene; returns it once live. Load failures route to `app.onError`. |
+| `Scenes` / `Scene` | components | Declarative scene switch over the one-active-scene model. Load failures route to `app.onError`. |
 | `useActiveScene()` | hook | The active scene instance from the nearest `<Scenes>`. |
+| `useSignal(signal, getSnapshot)` | hook | Subscribes to an engine `Signal` and re-renders on every dispatch (e.g. `app.onFrame`). |
 
 ### Reactivity model
 

package/dist/esm/ExoCanvas.d.ts

@@ -15,6 +15,13 @@ export interface ExoCanvasProps extends HTMLAttributes<HTMLDivElement> {
      * the first {@link import('./useScene').useScene} child calls `app.start()`.
      */
     onReady?: (app: Application) => void;
+    /**
+     * Called for every {@link Application.onError} dispatch — async init or
+     * scene-load failures (including the ones surfaced by
+     * {@link import('./useScene').useScene} and {@link import('./Scenes').Scenes}
+     * descendants) — while an Application exists.
+     */
+    onError?: (error: unknown) => void;
     /**
      * Props forwarded to the inner `<canvas>` (e.g. its own `style`/`className`).
      * `ref`, `width` and `height` are managed by the engine and cannot be set.
@@ -40,4 +47,4 @@ export interface ExoCanvasProps extends HTMLAttributes<HTMLDivElement> {
  * </ExoCanvas>
  * ```
  */
-export declare function ExoCanvas({ options, onReady, canvasProps, children, style, ...divProps }: ExoCanvasProps): ReactElement;
+export declare function ExoCanvas({ options, onReady, onError, canvasProps, children, style, ...divProps }: ExoCanvasProps): ReactElement;

package/dist/esm/ExoCanvas.js

@@ -24,8 +24,8 @@ const defaultCanvasStyle = { display: 'block' };
  * </ExoCanvas>
  * ```
  */
-function ExoCanvas({ options, onReady, canvasProps, children, style, ...divProps }) {
-    const { app, canvasRef } = useExoApplication(options, onReady);
+function ExoCanvas({ options, onReady, onError, canvasProps, children, style, ...divProps }) {
+    const { app, canvasRef } = useExoApplication(options, onReady, onError);
     const { style: canvasStyle, ...restCanvasProps } = canvasProps ?? {};
     const wrapperStyle = { position: 'relative', ...style };
     const mergedCanvasStyle = { ...defaultCanvasStyle, ...canvasStyle };

package/dist/esm/ExoCanvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExoCanvas.js","sources":["../../../src/ExoCanvas.tsx"],"sourcesContent":[null],"names":["_jsx","_jsxs"],"mappings":";;;;;AAMA;AACA,MAAM,kBAAkB,GAAkB,EAAE,OAAO,EAAE,OAAO,EAAE;AAuB9D;;;;;;;;;;;;;;;;;;AAkBG;SACa,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAkB,EAAA;AACvG,IAAA,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC;AAE9D,IAAA,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,GAAG,WAAW,IAAI,EAAE;IACpE,MAAM,YAAY,GAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE;IACtE,MAAM,iBAAiB,GAAkB,EAAE,GAAG,kBAAkB,EAAE,GAAG,WAAW,EAAE;AAElF,IAAA,QACEA,GAAA,CAAC,UAAU,CAAC,QAAQ,IAAC,KAAK,EAAE,GAAG,EAAA,QAAA,EAC7BC,cAAK,KAAK,EAAE,YAAY,EAAA,GAAM,QAAQ,EAAA,QAAA,EAAA,CACpCD,GAAA,CAAA,QAAA,EAAA,EAAQ,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,KAAM,eAAe,EAAA,CAAI,EACxE,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAA,EAAA,CACrB,EAAA,CACc;AAE1B;;;;"}
+{"version":3,"file":"ExoCanvas.js","sources":["../../../src/ExoCanvas.tsx"],"sourcesContent":[null],"names":["_jsx","_jsxs"],"mappings":";;;;;AAMA;AACA,MAAM,kBAAkB,GAAkB,EAAE,OAAO,EAAE,OAAO,EAAE;AA8B9D;;;;;;;;;;;;;;;;;;AAkBG;SACa,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAkB,EAAA;AAChH,IAAA,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;AAEvE,IAAA,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,GAAG,WAAW,IAAI,EAAE;IACpE,MAAM,YAAY,GAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE;IACtE,MAAM,iBAAiB,GAAkB,EAAE,GAAG,kBAAkB,EAAE,GAAG,WAAW,EAAE;AAElF,IAAA,QACEA,GAAA,CAAC,UAAU,CAAC,QAAQ,IAAC,KAAK,EAAE,GAAG,EAAA,QAAA,EAC7BC,cAAK,KAAK,EAAE,YAAY,EAAA,GAAM,QAAQ,EAAA,QAAA,EAAA,CACpCD,GAAA,CAAA,QAAA,EAAA,EAAQ,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,KAAM,eAAe,EAAA,CAAI,EACxE,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAA,EAAA,CACrB,EAAA,CACc;AAE1B;;;;"}

package/dist/esm/Scenes.d.ts

@@ -38,6 +38,11 @@ export interface ScenesProps {
  * (HUD overlay) render alongside, and can read the instance via
  * {@link useActiveScene}.
  *
+ * A failure in `app.start()`/`app.scene.setScene()` (e.g. a scene's `onLoad`
+ * rejects) is caught and routed to {@link Application.onError} rather than
+ * left as an unhandled promise rejection — subscribe via `app.onError.add(...)`
+ * or the {@link import('./ExoCanvas').ExoCanvas} `onError` prop to observe it.
+ *
  * @example
  * ```tsx
  * <ExoCanvas>

package/dist/esm/Scenes.js

@@ -30,6 +30,11 @@ function Scene(_props) {
  * (HUD overlay) render alongside, and can read the instance via
  * {@link useActiveScene}.
  *
+ * A failure in `app.start()`/`app.scene.setScene()` (e.g. a scene's `onLoad`
+ * rejects) is caught and routed to {@link Application.onError} rather than
+ * left as an unhandled promise rejection — subscribe via `app.onError.add(...)`
+ * or the {@link import('./ExoCanvas').ExoCanvas} `onError` prop to observe it.
+ *
  * @example
  * ```tsx
  * <ExoCanvas>
@@ -61,22 +66,32 @@ function Scenes({ active, transition, children }) {
     useEffect(() => {
         if (SceneClass === null) {
             setInstance(null);
-            void app.scene.setScene(null);
+            void app.scene.setScene(null).catch((error) => {
+                app.onError.dispatch(error instanceof Error ? error : new Error(String(error)));
+            });
             return;
         }
         let cancelled = false;
         const scene = new SceneClass();
         const apply = async () => {
-            if (app.status === ApplicationStatus.Stopped) {
-                // First activation initializes the backend and starts the frame loop;
-                // transitions only apply to subsequent switches.
-                await app.start(scene);
-            }
-            else {
-                await app.scene.setScene(scene, transition !== undefined ? { transition } : {});
+            try {
+                if (app.status === ApplicationStatus.Stopped) {
+                    // First activation initializes the backend and starts the frame loop;
+                    // transitions only apply to subsequent switches.
+                    await app.start(scene);
+                }
+                else {
+                    await app.scene.setScene(scene, transition !== undefined ? { transition } : {});
+                }
+                if (!cancelled) {
+                    setInstance(scene);
+                }
             }
-            if (!cancelled) {
-                setInstance(scene);
+            catch (error) {
+                // Route to Application.onError instead of leaving an unhandled
+                // rejection — app.start()/setScene() reject rather than dispatching
+                // onError themselves.
+                app.onError.dispatch(error instanceof Error ? error : new Error(String(error)));
             }
         };
         void apply();

package/dist/esm/Scenes.js.map

@@ -1 +1 @@
-{"version":3,"file":"Scenes.js","sources":["../../../src/Scenes.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;AAeA;AACA,MAAM,kBAAkB,GAAG,aAAa,CAAkB,IAAI,CAAC;AAC/D,kBAAkB,CAAC,WAAW,GAAG,gBAAgB;AAEjD;;;;AAIG;SACa,cAAc,GAAA;AAC5B,IAAA,OAAO,UAAU,CAAC,kBAAkB,CAAa;AACnD;AAYA;;;;AAIG;AACG,SAAU,KAAK,CAAC,MAAkB,EAAA;AACtC,IAAA,OAAO,IAAI;AACb;AAYA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAe,EAAA;AAClE,IAAA,MAAM,GAAG,GAAG,SAAS,EAAE;IACvB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAkB,IAAI,CAAC;;AAG/D,IAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAK;AAC5B,QAAA,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB;AACzC,QAAA,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAG;YACjC,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE;AACjD,gBAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAmB;gBACvC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;YAC5B;AACF,QAAA,CAAC,CAAC;AACF,QAAA,OAAO,GAAG;AACZ,IAAA,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;AAClC,IAAA,MAAM,UAAU,GAAG,KAAK,EAAE,SAAS,IAAI,IAAI;IAE3C,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,UAAU,KAAK,IAAI,EAAE;YACvB,WAAW,CAAC,IAAI,CAAC;YACjB,KAAK,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC7B;QACF;QAEA,IAAI,SAAS,GAAG,KAAK;AACrB,QAAA,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE;AAE9B,QAAA,MAAM,KAAK,GAAG,YAA0B;YACtC,IAAI,GAAG,CAAC,MAAM,KAAK,iBAAiB,CAAC,OAAO,EAAE;;;AAG5C,gBAAA,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;YACxB;iBAAO;gBACL,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,KAAK,SAAS,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;YACjF;YACA,IAAI,CAAC,SAAS,EAAE;gBACd,WAAW,CAAC,KAAK,CAAC;YACpB;AACF,QAAA,CAAC;QAED,KAAK,KAAK,EAAE;AAEZ,QAAA,OAAO,MAAK;YACV,SAAS,GAAG,IAAI;YAChB,WAAW,CAAC,IAAI,CAAC;AACnB,QAAA,CAAC;;;;AAIH,IAAA,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAEjB,IAAA,QACEA,GAAA,CAAC,kBAAkB,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,QAAQ,YACzC,QAAQ,KAAK,IAAI,IAAI,KAAK,EAAE,QAAQ,EAAA,CACT;AAElC;;;;"}
+{"version":3,"file":"Scenes.js","sources":["../../../src/Scenes.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;;;AAeA;AACA,MAAM,kBAAkB,GAAG,aAAa,CAAkB,IAAI,CAAC;AAC/D,kBAAkB,CAAC,WAAW,GAAG,gBAAgB;AAEjD;;;;AAIG;SACa,cAAc,GAAA;AAC5B,IAAA,OAAO,UAAU,CAAC,kBAAkB,CAAa;AACnD;AAYA;;;;AAIG;AACG,SAAU,KAAK,CAAC,MAAkB,EAAA;AACtC,IAAA,OAAO,IAAI;AACb;AAYA;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACG,SAAU,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAe,EAAA;AAClE,IAAA,MAAM,GAAG,GAAG,SAAS,EAAE;IACvB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAkB,IAAI,CAAC;;AAG/D,IAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAK;AAC5B,QAAA,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB;AACzC,QAAA,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAG;YACjC,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE;AACjD,gBAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAmB;gBACvC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;YAC5B;AACF,QAAA,CAAC,CAAC;AACF,QAAA,OAAO,GAAG;AACZ,IAAA,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;AAClC,IAAA,MAAM,UAAU,GAAG,KAAK,EAAE,SAAS,IAAI,IAAI;IAE3C,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,UAAU,KAAK,IAAI,EAAE;YACvB,WAAW,CAAC,IAAI,CAAC;AACjB,YAAA,KAAK,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,KAAI;gBACrD,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,YAAY,KAAK,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACjF,YAAA,CAAC,CAAC;YACF;QACF;QAEA,IAAI,SAAS,GAAG,KAAK;AACrB,QAAA,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE;AAE9B,QAAA,MAAM,KAAK,GAAG,YAA0B;AACtC,YAAA,IAAI;gBACF,IAAI,GAAG,CAAC,MAAM,KAAK,iBAAiB,CAAC,OAAO,EAAE;;;AAG5C,oBAAA,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;gBACxB;qBAAO;oBACL,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,KAAK,SAAS,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;gBACjF;gBACA,IAAI,CAAC,SAAS,EAAE;oBACd,WAAW,CAAC,KAAK,CAAC;gBACpB;YACF;YAAE,OAAO,KAAK,EAAE;;;;gBAId,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,YAAY,KAAK,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACjF;AACF,QAAA,CAAC;QAED,KAAK,KAAK,EAAE;AAEZ,QAAA,OAAO,MAAK;YACV,SAAS,GAAG,IAAI;YAChB,WAAW,CAAC,IAAI,CAAC;AACnB,QAAA,CAAC;;;;AAIH,IAAA,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAEjB,IAAA,QACEA,GAAA,CAAC,kBAAkB,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,QAAQ,YACzC,QAAQ,KAAK,IAAI,IAAI,KAAK,EAAE,QAAQ,EAAA,CACT;AAElC;;;;"}

package/dist/esm/index.d.ts

@@ -7,3 +7,4 @@ export { useExoApp } from './useExoApp';
 export type { ExoApplicationOptions, UseExoApplicationResult } from './useExoApplication';
 export { useExoApplication } from './useExoApplication';
 export { useScene } from './useScene';
+export { useSignal } from './useSignal';

package/dist/esm/index.js

@@ -4,4 +4,5 @@ export { Scene, Scenes, useActiveScene } from './Scenes.js';
 export { useExoApp } from './useExoApp.js';
 export { useExoApplication } from './useExoApplication.js';
 export { useScene } from './useScene.js';
+export { useSignal } from './useSignal.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/esm/useExoApp.d.ts

@@ -6,11 +6,17 @@ import type { Application } from '@codexo/exojs';
  *
  * @throws {Error} When no `<ExoCanvas>` ancestor is present.
  *
+ * `app.frameCount` is a plain getter updated by the engine's own frame loop —
+ * reading it here does not, on its own, make `HudOverlay` re-render. Pair it
+ * with {@link import('./useSignal').useSignal} to subscribe to `app.onFrame`
+ * and re-render on every dispatch.
+ *
  * @example
  * ```tsx
  * function HudOverlay() {
  *   const app = useExoApp();
- *   return <span>Frame: {app.frameCount}</span>;
+ *   const frameCount = useSignal(app.onFrame, () => app.frameCount);
+ *   return <span>Frame: {frameCount}</span>;
  * }
  * ```
  */

package/dist/esm/useExoApp.js

@@ -7,11 +7,17 @@ import { useExoContext } from './ExoContext.js';
  *
  * @throws {Error} When no `<ExoCanvas>` ancestor is present.
  *
+ * `app.frameCount` is a plain getter updated by the engine's own frame loop —
+ * reading it here does not, on its own, make `HudOverlay` re-render. Pair it
+ * with {@link import('./useSignal').useSignal} to subscribe to `app.onFrame`
+ * and re-render on every dispatch.
+ *
  * @example
  * ```tsx
  * function HudOverlay() {
  *   const app = useExoApp();
- *   return <span>Frame: {app.frameCount}</span>;
+ *   const frameCount = useSignal(app.onFrame, () => app.frameCount);
+ *   return <span>Frame: {frameCount}</span>;
  * }
  * ```
  */

package/dist/esm/useExoApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"useExoApp.js","sources":["../../../src/useExoApp.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;;;;;;AAcG;SACa,SAAS,GAAA;AACvB,IAAA,MAAM,GAAG,GAAG,aAAa,EAAE;AAE3B,IAAA,IAAI,GAAG,KAAK,IAAI,EAAE;AAChB,QAAA,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC;IAC5E;AAEA,IAAA,OAAO,GAAG;AACZ;;;;"}
+{"version":3,"file":"useExoApp.js","sources":["../../../src/useExoApp.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;;;;;;;;;;;;AAoBG;SACa,SAAS,GAAA;AACvB,IAAA,MAAM,GAAG,GAAG,aAAa,EAAE;AAE3B,IAAA,IAAI,GAAG,KAAK,IAAI,EAAE;AAChB,QAAA,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC;IAC5E;AAEA,IAAA,OAAO,GAAG;AACZ;;;;"}

package/dist/esm/useExoApplication.d.ts

@@ -53,5 +53,8 @@ export interface UseExoApplicationResult {
  *
  * @param options - Application options (the canvas element is the one you render).
  * @param onReady - Called once each time an Application is created.
+ * @param onError - Called for every {@link Application.onError} dispatch (async
+ *   init/scene-load failures) while an Application exists. Re-subscribed
+ *   automatically whenever the Application is (re)created.
  */
-export declare function useExoApplication(options?: ExoApplicationOptions, onReady?: (app: Application) => void): UseExoApplicationResult;
+export declare function useExoApplication(options?: ExoApplicationOptions, onReady?: (app: Application) => void, onError?: (error: unknown) => void): UseExoApplicationResult;

package/dist/esm/useExoApplication.js

@@ -36,8 +36,11 @@ function colorKey(color) {
  *
  * @param options - Application options (the canvas element is the one you render).
  * @param onReady - Called once each time an Application is created.
+ * @param onError - Called for every {@link Application.onError} dispatch (async
+ *   init/scene-load failures) while an Application exists. Re-subscribed
+ *   automatically whenever the Application is (re)created.
  */
-function useExoApplication(options, onReady) {
+function useExoApplication(options, onReady, onError) {
     const canvasRef = useRef(null);
     const [app, setApp] = useState(null);
     // Latest onReady without retriggering the lifecycle effect. Updated in an
@@ -46,6 +49,11 @@ function useExoApplication(options, onReady) {
     useEffect(() => {
         onReadyRef.current = onReady;
     });
+    // Latest onError without retriggering the subscribe effect below.
+    const onErrorRef = useRef(onError);
+    useEffect(() => {
+        onErrorRef.current = onError;
+    });
     // Identity: only the backend type forces a full recreation.
     const backendKey = options?.backend?.type ?? 'auto';
     // ── Lifecycle: create on mount / recreate on backend change ───────────────
@@ -71,6 +79,19 @@ function useExoApplication(options, onReady) {
         // by the effects below. `options` is intentionally read at (re)create time.
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [backendKey]);
+    // ── Live sync: error reporting ─────────────────────────────────────────────
+    useEffect(() => {
+        if (app === null) {
+            return;
+        }
+        const handleError = (error) => {
+            onErrorRef.current?.(error);
+        };
+        app.onError.add(handleError);
+        return () => {
+            app.onError.remove(handleError);
+        };
+    }, [app]);
     // ── Live sync: size ───────────────────────────────────────────────────────
     const width = options?.canvas?.width;
     const height = options?.canvas?.height;

package/dist/esm/useExoApplication.js.map

@@ -1 +1 @@
-{"version":3,"file":"useExoApplication.js","sources":["../../../src/useExoApplication.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AA2BA;AACA,SAAS,QAAQ,CAAC,KAAwB,EAAA;IACxC,OAAO,KAAK,KAAK,SAAS,GAAG,SAAS,GAAG,CAAA,EAAG,KAAK,CAAC,CAAC,CAAA,CAAA,EAAI,KAAK,CAAC,CAAC,CAAA,CAAA,EAAI,KAAK,CAAC,CAAC,CAAA,CAAA,EAAI,KAAK,CAAC,CAAC,CAAA,CAAE;AACxF;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BG;AACG,SAAU,iBAAiB,CAC/B,OAA+B,EAC/B,OAAoC,EAAA;AAEpC,IAAA,MAAM,SAAS,GAAG,MAAM,CAAoB,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC;;;AAIxD,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;IAClC,SAAS,CAAC,MAAK;AACb,QAAA,UAAU,CAAC,OAAO,GAAG,OAAO;AAC9B,IAAA,CAAC,CAAC;;IAGF,MAAM,UAAU,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,MAAM;;IAGnD,SAAS,CAAC,MAAK;AACb,QAAA,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO;QAChC,IAAI,CAAC,MAAM,EAAE;YACX;QACF;;;;AAKA,QAAA,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;AAClC,YAAA,GAAG,OAAO;YACV,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;AAChD,SAAA,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC;AACnB,QAAA,UAAU,CAAC,OAAO,GAAG,WAAW,CAAC;AAEjC,QAAA,OAAO,MAAK;YACV,WAAW,CAAC,OAAO,EAAE;YACrB,MAAM,CAAC,IAAI,CAAC;AACd,QAAA,CAAC;;;;AAIH,IAAA,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;;AAGhB,IAAA,MAAM,KAAK,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK;AACpC,IAAA,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM;IACtC,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE;AAC/D,YAAA,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;QAC3B;IACF,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;;AAGxB,IAAA,MAAM,UAAU,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU;IAC9C,SAAS,CAAC,MAAK;QACb,IAAI,GAAG,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE;AAC5C,YAAA,GAAG,CAAC,UAAU,GAAG,UAAU;QAC7B;AACF,IAAA,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;;AAGrB,IAAA,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU;AACtC,IAAA,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC;IACrC,SAAS,CAAC,MAAK;QACb,IAAI,GAAG,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE;AAC5C,YAAA,GAAG,CAAC,UAAU,GAAG,UAAU;QAC7B;;;AAGF,IAAA,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAEnB,IAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE;AAC3B;;;;"}
+{"version":3,"file":"useExoApplication.js","sources":["../../../src/useExoApplication.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/useScene.d.ts

@@ -12,6 +12,12 @@ import { type DependencyList } from 'react';
  * The scene is cleared (`setScene(null)`) when the component unmounts or
  * when `deps` change — mirroring `useEffect` semantics.
  *
+ * A failure in `app.start()`/`app.scene.setScene()` (e.g. a scene's `onLoad`
+ * rejects) is caught and routed to {@link Application.onError} rather than
+ * left as an unhandled promise rejection — subscribe via
+ * `app.onError.add(...)` or the {@link import('./ExoCanvas').ExoCanvas}
+ * `onError` prop to observe it.
+ *
  * @param SceneClass - Constructor for the scene to instantiate.
  * @param deps - Extra deps that trigger scene replacement when changed, in
  *   addition to the stable `app` reference (same semantics as `useEffect`).

package/dist/esm/useScene.js

@@ -14,6 +14,12 @@ import { useExoApp } from './useExoApp.js';
  * The scene is cleared (`setScene(null)`) when the component unmounts or
  * when `deps` change — mirroring `useEffect` semantics.
  *
+ * A failure in `app.start()`/`app.scene.setScene()` (e.g. a scene's `onLoad`
+ * rejects) is caught and routed to {@link Application.onError} rather than
+ * left as an unhandled promise rejection — subscribe via
+ * `app.onError.add(...)` or the {@link import('./ExoCanvas').ExoCanvas}
+ * `onError` prop to observe it.
+ *
  * @param SceneClass - Constructor for the scene to instantiate.
  * @param deps - Extra deps that trigger scene replacement when changed, in
  *   addition to the stable `app` reference (same semantics as `useEffect`).
@@ -36,16 +42,24 @@ function useScene(SceneClass, deps = []) {
         let cancelled = false;
         const s = new SceneClass();
         const apply = async () => {
-            if (app.status === ApplicationStatus.Stopped) {
-                // First activation — initialize the backend and start the frame loop.
-                await app.start(s);
-            }
-            else {
-                // Engine already running — switch scenes without restarting.
-                await app.scene.setScene(s);
+            try {
+                if (app.status === ApplicationStatus.Stopped) {
+                    // First activation — initialize the backend and start the frame loop.
+                    await app.start(s);
+                }
+                else {
+                    // Engine already running — switch scenes without restarting.
+                    await app.scene.setScene(s);
+                }
+                if (!cancelled) {
+                    setScene(s);
+                }
             }
-            if (!cancelled) {
-                setScene(s);
+            catch (error) {
+                // Route to Application.onError instead of leaving an unhandled
+                // rejection — app.start()/setScene() reject rather than dispatching
+                // onError themselves.
+                app.onError.dispatch(error instanceof Error ? error : new Error(String(error)));
             }
         };
         void apply();
@@ -54,7 +68,9 @@ function useScene(SceneClass, deps = []) {
             setScene(null);
             // Best-effort scene clear; the Application.destroy() called by
             // ExoCanvas cleanup will also handle any remaining active scene.
-            void app.scene.setScene(null);
+            void app.scene.setScene(null).catch((error) => {
+                app.onError.dispatch(error instanceof Error ? error : new Error(String(error)));
+            });
         };
         // SceneClass is intentionally excluded from deps: a new class reference
         // (e.g. inline arrow class) on every render would recreate the scene

package/dist/esm/useScene.js.map

@@ -1 +1 @@
-{"version":3,"file":"useScene.js","sources":["../../../src/useScene.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACH;SACgB,QAAQ,CAAkB,UAAuB,EAAE,OAAuB,EAAE,EAAA;AAC1F,IAAA,MAAM,GAAG,GAAG,SAAS,EAAE;IACvB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC;IAElD,SAAS,CAAC,MAAK;QACb,IAAI,SAAS,GAAG,KAAK;AACrB,QAAA,MAAM,CAAC,GAAG,IAAI,UAAU,EAAE;AAE1B,QAAA,MAAM,KAAK,GAAG,YAA0B;YACtC,IAAI,GAAG,CAAC,MAAM,KAAK,iBAAiB,CAAC,OAAO,EAAE;;AAE5C,gBAAA,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YACpB;iBAAO;;gBAEL,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC7B;YAEA,IAAI,CAAC,SAAS,EAAE;gBACd,QAAQ,CAAC,CAAC,CAAC;YACb;AACF,QAAA,CAAC;QAED,KAAK,KAAK,EAAE;AAEZ,QAAA,OAAO,MAAK;YACV,SAAS,GAAG,IAAI;YAChB,QAAQ,CAAC,IAAI,CAAC;;;YAGd,KAAK,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;AAC/B,QAAA,CAAC;;;;IAIH,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAElB,IAAA,OAAO,KAAK;AACd;;;;"}
+{"version":3,"file":"useScene.js","sources":["../../../src/useScene.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BG;AACH;SACgB,QAAQ,CAAkB,UAAuB,EAAE,OAAuB,EAAE,EAAA;AAC1F,IAAA,MAAM,GAAG,GAAG,SAAS,EAAE;IACvB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC;IAElD,SAAS,CAAC,MAAK;QACb,IAAI,SAAS,GAAG,KAAK;AACrB,QAAA,MAAM,CAAC,GAAG,IAAI,UAAU,EAAE;AAE1B,QAAA,MAAM,KAAK,GAAG,YAA0B;AACtC,YAAA,IAAI;gBACF,IAAI,GAAG,CAAC,MAAM,KAAK,iBAAiB,CAAC,OAAO,EAAE;;AAE5C,oBAAA,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpB;qBAAO;;oBAEL,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC7B;gBAEA,IAAI,CAAC,SAAS,EAAE;oBACd,QAAQ,CAAC,CAAC,CAAC;gBACb;YACF;YAAE,OAAO,KAAK,EAAE;;;;gBAId,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,YAAY,KAAK,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACjF;AACF,QAAA,CAAC;QAED,KAAK,KAAK,EAAE;AAEZ,QAAA,OAAO,MAAK;YACV,SAAS,GAAG,IAAI;YAChB,QAAQ,CAAC,IAAI,CAAC;;;AAGd,YAAA,KAAK,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,KAAI;gBACrD,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,YAAY,KAAK,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACjF,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC;;;;IAIH,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAElB,IAAA,OAAO,KAAK;AACd;;;;"}

package/dist/esm/useSignal.d.ts

@@ -0,0 +1,28 @@
+import type { Signal } from '@codexo/exojs';
+/**
+ * Subscribes to an ExoJS {@link Signal} and returns the latest value computed by
+ * `getSnapshot`, re-rendering the component every time the signal dispatches.
+ * Built on `useSyncExternalStore`, so reads stay tear-free under concurrent
+ * rendering.
+ *
+ * The signal itself is only used to know *when* to re-read — `getSnapshot` is
+ * responsible for producing the actual value (usually a getter on the engine
+ * object the signal lives on).
+ *
+ * @example
+ * ```tsx
+ * function FrameCounter() {
+ *   const app = useExoApp();
+ *   // Re-renders on every `onFrame` dispatch (i.e. every engine frame).
+ *   const frameCount = useSignal(app.onFrame, () => app.frameCount);
+ *   return <span>Frame: {frameCount}</span>;
+ * }
+ * ```
+ *
+ * @param signal - The signal to subscribe to. `null`/`undefined` is accepted
+ *   (e.g. before an `Application` exists) — the hook simply does not subscribe
+ *   to anything and `getSnapshot` still runs on every render.
+ * @param getSnapshot - Reads the current value. Called on mount and again after
+ *   every dispatch of `signal`.
+ */
+export declare function useSignal<Args extends unknown[], T>(signal: Signal<Args> | null | undefined, getSnapshot: () => T): T;

package/dist/esm/useSignal.js

@@ -0,0 +1,45 @@
+import { useCallback, useSyncExternalStore } from 'react';
+
+/**
+ * Subscribes to an ExoJS {@link Signal} and returns the latest value computed by
+ * `getSnapshot`, re-rendering the component every time the signal dispatches.
+ * Built on `useSyncExternalStore`, so reads stay tear-free under concurrent
+ * rendering.
+ *
+ * The signal itself is only used to know *when* to re-read — `getSnapshot` is
+ * responsible for producing the actual value (usually a getter on the engine
+ * object the signal lives on).
+ *
+ * @example
+ * ```tsx
+ * function FrameCounter() {
+ *   const app = useExoApp();
+ *   // Re-renders on every `onFrame` dispatch (i.e. every engine frame).
+ *   const frameCount = useSignal(app.onFrame, () => app.frameCount);
+ *   return <span>Frame: {frameCount}</span>;
+ * }
+ * ```
+ *
+ * @param signal - The signal to subscribe to. `null`/`undefined` is accepted
+ *   (e.g. before an `Application` exists) — the hook simply does not subscribe
+ *   to anything and `getSnapshot` still runs on every render.
+ * @param getSnapshot - Reads the current value. Called on mount and again after
+ *   every dispatch of `signal`.
+ */
+function useSignal(signal, getSnapshot) {
+    const subscribe = useCallback((onStoreChange) => {
+        if (!signal) {
+            // No signal to subscribe to (e.g. before an Application exists) — nothing to unsubscribe either.
+            // eslint-disable-next-line @typescript-eslint/no-empty-function -- intentional no-op unsubscribe
+            return () => { };
+        }
+        signal.add(onStoreChange);
+        return () => {
+            signal.remove(onStoreChange);
+        };
+    }, [signal]);
+    return useSyncExternalStore(subscribe, getSnapshot);
+}
+
+export { useSignal };
+//# sourceMappingURL=useSignal.js.map

package/dist/esm/useSignal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSignal.js","sources":["../../../src/useSignal.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACG,SAAU,SAAS,CAA4B,MAAuC,EAAE,WAAoB,EAAA;AAChH,IAAA,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,aAAyB,KAAkB;QAC1C,IAAI,CAAC,MAAM,EAAE;;;AAGX,YAAA,OAAO,MAAK,EAAE,CAAC;QACjB;AAEA,QAAA,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;AAEzB,QAAA,OAAO,MAAK;AACV,YAAA,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;AAC9B,QAAA,CAAC;AACH,IAAA,CAAC,EACD,CAAC,MAAM,CAAC,CACT;AAED,IAAA,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,CAAC;AACrD;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexo/exojs-react",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "React integration for ExoJS.",
   "repository": {
     "type": "git",
@@ -8,6 +8,7 @@
     "directory": "packages/exojs-react"
   },
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/esm/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
@@ -25,7 +26,7 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "@codexo/exojs": "0.14.x",
+    "@codexo/exojs": "0.15.x",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
   },
@@ -36,7 +37,7 @@
   },
   "devDependencies": {
     "@types/react": "^18.0.0",
-    "@codexo/exojs": "0.14.0",
+    "@codexo/exojs": "0.15.0",
     "@codexo/exojs-config": "0.0.0"
   },
   "license": "MIT",