@threenative/core 0.1.0 → 0.3.0

package/dist/hot.d.ts

@@ -1,9 +1,11 @@
-import { a as audioRuntimeSnapshot } from './audio-3vkjtiuo.js';
-import { G as Game } from './game-DRPs3M7r.js';
+import { a as audioRuntimeSnapshot } from './audio-Dp2mXpD3.js';
+import { I as IGame } from './game-CYIaKhgl.js';
 import 'three';
+import './canvas-layer-CtrZHgIh.js';
+import 'three/webgpu';
 import 'zustand/vanilla';
 
-interface HotDiagnostics {
+interface IHotDiagnostics {
     readonly reloads: number;
     readonly entities: number;
     readonly sceneObjects: number;
@@ -11,7 +13,33 @@ interface HotDiagnostics {
     readonly audio: ReturnType<typeof audioRuntimeSnapshot>;
     readonly physics: number | null;
 }
+/**
+ * Validate that hot-reload state can cross the Vite boundary.
+ * @situation preserve JSON-shaped state during hot reload
+ * @situation reject a non-portable game state before reload
+ * @constraint state must contain finite numbers and plain objects only
+ * @example assertPortableState(game.state.getState());
+ */
 declare function assertPortableState(state: unknown): void;
-declare function acceptHotUpdate<TState extends Record<string, unknown>, TPhysics>(game: Game<TState, TPhysics>, hot: ImportMeta["hot"]): void;
+/**
+ * Register hot-reload state preservation for a game.
+ * @situation keep game state while editing source in development
+ * @situation diagnose state shape changes during hot reload
+ * @constraint use only in the web development entry
+ * @example acceptHotUpdate(game, import.meta.hot);
+ */
+declare function acceptHotUpdate<TState extends Record<string, unknown>, TPhysics>(game: IGame<TState, TPhysics>, hot: IImportMeta["hot"]): void;
+interface IImportMeta {
+    readonly env?: {
+        readonly DEV?: boolean;
+    };
+    readonly hot?: IViteHotContext;
+}
+interface IViteHotContext {
+    readonly data: Record<string, unknown>;
+    accept(): void;
+    dispose(callback: (data: Record<string, unknown>) => void): void;
+    invalidate(message?: string): void;
+}
 
-export { type HotDiagnostics, acceptHotUpdate, assertPortableState };
+export { type IHotDiagnostics, acceptHotUpdate, assertPortableState };

package/dist/hot.js

@@ -5,11 +5,13 @@ var buses = /* @__PURE__ */ new Set();
 function audioRuntimeSnapshot() {
   let queued = 0;
   let voices = 0;
+  let pooled = 0;
   for (const bus of buses) {
     queued += bus.queued;
     voices += bus.voices;
+    pooled += bus.pooled;
   }
-  return { queued, voices };
+  return { pooled, queued, voices };
 }
 
 // src/hot.ts
@@ -23,6 +25,12 @@ function acceptHotUpdate(game, hot) {
   const carried = hot.data.threenative;
   const reloads = carried?.reloads ?? 0;
   if (carried !== void 0) restoreState(game, carried.state);
+  if (carried?.sceneName !== void 0) {
+    try {
+      game.resumeScene(carried.sceneName);
+    } catch {
+    }
+  }
   if (isDev && typeof window !== "undefined") {
     const host = window;
     host.__THREENATIVE__ = {
@@ -39,7 +47,7 @@ function acceptHotUpdate(game, hot) {
       game.state.flush();
       const state = game.state.getState();
       assertPortableState(state);
-      data.threenative = { reloads: reloads + 1, state };
+      data.threenative = { reloads: reloads + 1, sceneName: game.sceneName, state };
     } catch (error) {
       data.threenative = void 0;
       hot.invalidate(error instanceof Error ? error.message : String(error));