incanto 0.68.0 → 0.70.0

package/templates-app/beacon-isle-3d/src/main.ts

@@ -19,8 +19,18 @@ await preloadUrls(assetUrls(gameJson.assets), (done, total) => {
 });
 
 const canvas = document.querySelector('canvas') as HTMLCanvasElement;
+/** Dev-only surfaces: the ☰ debug overlay, and the editor behind it. */
+const DEBUG = import.meta.env.VITE_INCANTO_DEBUG === '1';
+
 const game = await createGame3D({
-  debug: import.meta.env.VITE_INCANTO_DEBUG === '1',
+  debug: DEBUG,
+  // The editor's 📚 buttons, served by `incantoLibrary()` in vite.config.ts.
+  // BOTH halves are the opt-in, and this half was missing from every shipped
+  // template: the plugin alone left a vite config whose own comment promised
+  // "the agent8 asset catalog behind the 📚 buttons" and no button anywhere.
+  // Gated on the same flag, because `editor` DEFAULTS to `debug` and an object
+  // here would turn the editor on in a production build.
+  editor: DEBUG && { library: true },
   canvas,
   scene: gameJson,
   behaviors: BEHAVIORS,
@@ -34,7 +44,17 @@ const game = await createGame3D({
   throw e;
 });
 
-document.querySelector('#loading')?.remove();
-
-// console-poking handle for playtesting
+// The console handle FIRST, before any wiring of your own can throw.
+// `game.stats()`, `game.assetErrors()`, `game.frame()` and `game.engine.log`
+// are the entire in-page diagnostic surface, and a static build has no other.
+// Assigned after the wiring, one mistake below took all of them with it.
 (window as unknown as { game: typeof game }).game = game;
+
+// The overlay comes down LAST, after any wiring of your own. There is none in
+// this template — when you add some, put it above this line and wrap it:
+//
+//   try { …your wiring… } catch (e) { showBootFailure(e); throw e; }
+//
+// A throw between the overlay coming down and the handle going up used to leave
+// a level that renders perfectly with no player and no error of any kind.
+document.querySelector('#loading')?.remove();

package/templates-app/beacon-isle-3d/tsconfig.json

@@ -9,5 +9,5 @@
     "resolveJsonModule": true,
     "types": ["vite/client", "node"]
   },
-  "include": ["src", "verify.ts"]
+  "include": ["src", "verify.ts", "vite.config.ts"]
 }

package/templates-app/beacon-isle-3d/verify.ts

@@ -258,7 +258,9 @@ const ok = (label: string, cond: boolean): void => {
   resetQuest();
   const boot = async (): Promise<Engine> => {
     const engine = new Engine({ seed: 42, scheduler: () => () => {} });
-    engine.setScene(loadScene(structuredClone(gameJson) as Parameters<typeof loadScene>[0]));
+    engine.setScene(
+      loadScene(structuredClone(gameJson) as Parameters<typeof loadScene>[0], { engine }),
+    );
     await enablePhysics3D(engine);
     return engine;
   };