npm - incanto - Versions diffs - 0.77.0 → 0.78.1 - Mend

incanto 0.77.0 → 0.78.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (71) hide show

package/README.md +9 -4
package/dist/index.js +1 -1
package/dist/{src-DygJfhOb.js → src-SWXe-bub.js} +1 -1
package/dist/vite.js +1 -1
package/package.json +1 -1
package/skills/incanto-building-2d-games.md +6 -0
package/skills/incanto-building-3d-games.md +6 -0
package/skills/incanto-editor.md +2 -2
package/skills/incanto-multiplayer.md +1 -1
package/skills/incanto-save-slots.md +1 -1
package/skills/incanto-scene-json-authoring.md +1 -1
package/skills/incanto-verifying-your-game.md +2 -2
package/skills/incanto-web-integration.md +40 -2
package/skills/incanto-your-first-game.md +6 -1
package/templates-app/beacon-isle-3d/PROJECT/Structure.md +2 -1
package/templates-app/beacon-isle-3d/index.html +5 -2
package/templates-app/beacon-isle-3d/package.json +6 -1
package/templates-app/beacon-isle-3d/src/App.tsx +77 -0
package/templates-app/beacon-isle-3d/src/main.tsx +9 -0
package/templates-app/beacon-isle-3d/tsconfig.json +2 -1
package/templates-app/beacon-isle-3d/vite.config.ts +4 -1
package/templates-app/molehill-2d/PROJECT/Structure.md +2 -1
package/templates-app/molehill-2d/index.html +5 -2
package/templates-app/molehill-2d/package.json +6 -1
package/templates-app/molehill-2d/src/App.tsx +58 -0
package/templates-app/molehill-2d/src/main.tsx +9 -0
package/templates-app/molehill-2d/tsconfig.json +2 -1
package/templates-app/molehill-2d/vite.config.ts +4 -1
package/templates-app/platformer-2d/PROJECT/Context.md +1 -1
package/templates-app/platformer-2d/PROJECT/Requirements.md +2 -2
package/templates-app/platformer-2d/PROJECT/Status.md +1 -1
package/templates-app/platformer-2d/PROJECT/Structure.md +2 -2
package/templates-app/platformer-2d/docs/project-2d-rules.md +1 -1
package/templates-app/platformer-2d/index.html +5 -2
package/templates-app/platformer-2d/package.json +6 -1
package/templates-app/platformer-2d/src/App.tsx +115 -0
package/templates-app/platformer-2d/src/main.tsx +9 -0
package/templates-app/platformer-2d/tsconfig.json +2 -1
package/templates-app/platformer-2d/vite.config.ts +4 -1
package/templates-app/star-survivor/PROJECT/Context.md +1 -1
package/templates-app/star-survivor/PROJECT/Requirements.md +1 -1
package/templates-app/star-survivor/PROJECT/Status.md +1 -1
package/templates-app/star-survivor/PROJECT/Structure.md +2 -2
package/templates-app/star-survivor/docs/project-2d-rules.md +1 -1
package/templates-app/star-survivor/index.html +5 -2
package/templates-app/star-survivor/package.json +6 -1
package/templates-app/star-survivor/src/App.tsx +94 -0
package/templates-app/star-survivor/src/main.tsx +9 -0
package/templates-app/star-survivor/tsconfig.json +2 -1
package/templates-app/star-survivor/vite.config.ts +4 -1
package/templates-app/tps-3d/PROJECT/Status.md +1 -1
package/templates-app/tps-3d/PROJECT/Structure.md +2 -2
package/templates-app/tps-3d/index.html +5 -2
package/templates-app/tps-3d/package.json +6 -1
package/templates-app/tps-3d/src/App.tsx +124 -0
package/templates-app/tps-3d/src/main.tsx +9 -0
package/templates-app/tps-3d/tsconfig.json +2 -1
package/templates-app/tps-3d/vite.config.ts +4 -1
package/templates-app/village-quest-3d/PROJECT/Structure.md +3 -2
package/templates-app/village-quest-3d/index.html +5 -2
package/templates-app/village-quest-3d/package.json +6 -1
package/templates-app/village-quest-3d/src/App.tsx +79 -0
package/templates-app/village-quest-3d/src/main.tsx +9 -0
package/templates-app/village-quest-3d/tsconfig.json +2 -1
package/templates-app/village-quest-3d/vite.config.ts +4 -1
package/templates-app/beacon-isle-3d/src/main.ts +0 -60
package/templates-app/molehill-2d/src/main.ts +0 -41
package/templates-app/platformer-2d/src/main.ts +0 -97
package/templates-app/star-survivor/src/main.ts +0 -77
package/templates-app/tps-3d/src/main.ts +0 -107
package/templates-app/village-quest-3d/src/main.ts +0 -62

package/templates-app/tps-3d/src/main.tsx ADDED Viewed

@@ -0,0 +1,9 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import { App } from './App';
+createRoot(document.getElementById('root') as HTMLElement).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/templates-app/tps-3d/tsconfig.json CHANGED Viewed

@@ -7,7 +7,8 @@
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,
-    "types": ["vite/client", "node"]
+    "types": ["vite/client", "node"],
+    "jsx": "react-jsx"
   },
   "include": ["src", "verify.ts", "vite.config.ts"]
 }

package/templates-app/tps-3d/vite.config.ts CHANGED Viewed

@@ -1,12 +1,15 @@
+import react from '@vitejs/plugin-react';
 import { incantoLibrary, incantoScenes } from 'incanto/vite';
 import { defineConfig } from 'vite';
 export default defineConfig({
   base: './',
+  // react(): the app entry is React — src/main.tsx mounts <App />, and App.tsx
+  //   owns the canvas the engine draws into.
   // Dev-server only, and both are why the editor is useful here:
   // - incantoScenes(): validates every *.scene.json the moment you save it,
   //   AND serves this project's scenes, so the editor (☰ debug ▸ edit this
   //   scene ▸ scenes) can open, create and save any scene in the project.
   // - incantoLibrary(): the agent8 asset catalog behind the 📚 buttons.
-  plugins: [incantoScenes(), incantoLibrary()],
+  plugins: [react(), incantoScenes(), incantoLibrary()],
 });

package/templates-app/village-quest-3d/PROJECT/Structure.md CHANGED Viewed

@@ -2,7 +2,8 @@
 ```
 index.html               canvas + loading bar
-src/main.ts              preload GLB/anim assets → createGame3D (village)
+src/main.tsx             React entry — mounts <App /> into #root
+src/App.tsx              preload GLB/anim assets → createGame3D (village)
 src/village.scene.json   sunset village: Elder (Interactable), gate Area3D,
                          player rig (controller `animations` map, sword Trail3D),
                          HUD (UiText/UiBanner/UiDialogue/UiButton)
@@ -20,7 +21,7 @@ verify.ts                audit + headless quest E2E + replay determinism
 ## Scene relationship
-`main.ts` boots the **village**. `goToScene(grove)` happens in
+`App.tsx` boots the **village**. `goToScene(grove)` happens in
 VillageDirector.onGateEnter; `goToScene(village)` in GroveDirector.onPortalEnter
 and the play-again button. Both scenes redeclare the same input map and player
 rig — scenes are self-contained by design (a scene JSON is the whole truth).

package/templates-app/village-quest-3d/index.html CHANGED Viewed

@@ -54,15 +54,18 @@
         font-size: 0.85rem;
         color: #aaa;
       }
+      #root {
+        display: contents;
+      }
     </style>
   </head>
   <body>
-    <canvas></canvas>
+    <div id="root"></div>
     <div id="loading" class="loading-container">
       <div class="loading-title">Emberwood</div>
       <div class="progress-track"><div id="progress"></div></div>
       <div id="progress-text">0%</div>
     </div>
-    <script type="module" src="/src/main.ts"></script>
+    <script type="module" src="/src/main.tsx"></script>
   </body>
 </html>

package/templates-app/village-quest-3d/package.json CHANGED Viewed

@@ -13,12 +13,17 @@
     "@dimforge/rapier2d-compat": "0.19.3",
     "@dimforge/rapier3d-compat": "0.19.3",
     "@pixiv/three-vrm": "^3.5.3",
-    "incanto": "^0.77.0",
+    "incanto": "^0.78.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "three": "^0.184.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
     "@types/three": "^0.184.1",
+    "@vitejs/plugin-react": "^6.0.3",
     "typescript": "^6.0.3",
     "vite": "^8.0.16"
   }

package/templates-app/village-quest-3d/src/App.tsx ADDED Viewed

@@ -0,0 +1,79 @@
+/**
+ * Emberwood — a 3D quest vignette showcasing the 0.8 engine surface.
+ * Talk to the Elder (UiDialogue + choices), take the quest, sprint through the
+ * north gate (goToScene fade) into a hedge-maze grove where three wolves walk
+ * A* patrol rings (findPath + PathFollow), fell them with a sword arc
+ * (Trail3D), and report back. Wind is a live synth voice (startVoice) that
+ * rises as you run; the character animates through the controller's
+ * declarative `animations` map — zero animation code.
+ */
+import { assetUrls, preloadUrls } from 'incanto';
+import { createGame3D, showBootFailure } from 'incanto/3d';
+import { useEffect, useRef } from 'react';
+import { BEHAVIORS } from './behaviors';
+import villageJson from './village.scene.json';
+export function App() {
+  const canvasRef = useRef<HTMLCanvasElement>(null);
+  useEffect(() => {
+    const canvas = canvasRef.current;
+    // StrictMode runs this effect twice against the SAME canvas element, and a
+    // second engine on one canvas is two renderers fighting for one context.
+    // The flag lives on the element, so it lasts exactly as long as the thing
+    // it guards — a page-level game like this one never unmounts otherwise.
+    if (!canvas || (canvas as { _incanto?: true })._incanto) return;
+    (canvas as { _incanto?: true })._incanto = true;
+    void (async () => {
+      const fill = document.querySelector('#progress') as HTMLElement | null;
+      const text = document.querySelector('#progress-text') as HTMLElement | null;
+      await preloadUrls(assetUrls(villageJson.assets), (done, total) => {
+        const pct = total > 0 ? Math.round((done / total) * 100) : 100;
+        if (fill) fill.style.width = `${pct}%`;
+        if (text) text.textContent = `${pct}%`;
+      });
+      /** 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: 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: villageJson,
+        behaviors: BEHAVIORS,
+        pointer: true, // pointer-lock look (click the canvas)
+      }).catch((e) => {
+        // Without this the player watches the loading overlay sit at 100% forever:
+        // `#loading` is removed on the line below, so anything that rejects here (no
+        // WebGL context, a scene that will not load) leaves the bar up and the reason
+        // in a console nobody opens.
+        showBootFailure(e);
+        throw e;
+      });
+      // 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();
+    })();
+  }, []);
+  return <canvas ref={canvasRef} id="game" />;
+}

package/templates-app/village-quest-3d/src/main.tsx ADDED Viewed

@@ -0,0 +1,9 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import { App } from './App';
+createRoot(document.getElementById('root') as HTMLElement).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/templates-app/village-quest-3d/tsconfig.json CHANGED Viewed

@@ -7,7 +7,8 @@
     "noEmit": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,
-    "types": ["vite/client", "node"]
+    "types": ["vite/client", "node"],
+    "jsx": "react-jsx"
   },
   "include": ["src", "verify.ts", "vite.config.ts"]
 }

package/templates-app/village-quest-3d/vite.config.ts CHANGED Viewed

@@ -1,12 +1,15 @@
+import react from '@vitejs/plugin-react';
 import { incantoLibrary, incantoScenes } from 'incanto/vite';
 import { defineConfig } from 'vite';
 export default defineConfig({
   base: './',
+  // react(): the app entry is React — src/main.tsx mounts <App />, and App.tsx
+  //   owns the canvas the engine draws into.
   // Dev-server only, and both are why the editor is useful here:
   // - incantoScenes(): validates every *.scene.json the moment you save it,
   //   AND serves this project's scenes, so the editor (☰ debug ▸ edit this
   //   scene ▸ scenes) can open, create and save any scene in the project.
   // - incantoLibrary(): the agent8 asset catalog behind the 📚 buttons.
-  plugins: [incantoScenes(), incantoLibrary()],
+  plugins: [react(), incantoScenes(), incantoLibrary()],
 });

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

@@ -1,60 +0,0 @@
-/**
- * Beacon Isle — the incanto 3D template: a generated island (terrain, sea,
- * groves, grass, flowers), a quest with a real NPC, shades that HUNT you
- * across the surface via terrain navigation, melee with a bone-mounted sword,
- * golden-hour grade + bloom, touch controls on phones — regenerate the whole
- * world with `bun run world`, the game logic never changes.
- */
-import { assetUrls, preloadUrls } from 'incanto';
-import { createGame3D, showBootFailure } from 'incanto/3d';
-import { BEHAVIORS } from './behaviors';
-import gameJson from './game.scene.json';
-const fill = document.querySelector('#progress') as HTMLElement | null;
-const text = document.querySelector('#progress-text') as HTMLElement | null;
-await preloadUrls(assetUrls(gameJson.assets), (done, total) => {
-  const pct = total > 0 ? Math.round((done / total) * 100) : 100;
-  if (fill) fill.style.width = `${pct}%`;
-  if (text) text.textContent = `${pct}%`;
-});
-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: 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,
-  pointer: true,
-}).catch((e) => {
-  // Without this the player watches the loading overlay sit at 100% forever:
-  // `#loading` is removed on the line below, so anything that rejects here (no
-  // WebGL context, a scene that will not load) leaves the bar up and the reason
-  // in a console nobody opens.
-  showBootFailure(e);
-  throw e;
-});
-// 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/molehill-2d/src/main.ts DELETED Viewed

@@ -1,41 +0,0 @@
-/**
- * Molehill — a whack-a-mole you play with the MOUSE and nothing else.
- *
- * No character body, no keyboard, no gravity. Nine holes, a mole that pops out
- * of one of them, three misses before they win. The engine's `Clickable` turns
- * each mole into a node that reports being clicked; the built-in `ScoreKeeper`
- * holds the score and the misses; the wiring between them is `game.scene.json`.
- *
- * It is the starter for a whole family the other templates do not cover —
- * match-3, tower defense, cards, point-and-click, RTS, board games, idle.
- */
-import { createGame2D, showBootFailure } from 'incanto/2d';
-import { Molehill, Scoreboard } from './behaviors';
-import sceneJson from './game.scene.json';
-/** Dev-only surfaces: the ☰ debug overlay, and the editor behind it. */
-const DEBUG = import.meta.env.VITE_INCANTO_DEBUG === '1';
-const canvas = document.querySelector('canvas') as HTMLCanvasElement;
-try {
-  const game = await createGame2D({
-    canvas,
-    scene: sceneJson,
-    behaviors: { Molehill, Scoreboard },
-    // The cursor is the input. `lockOnClick` would HIDE it, which is exactly
-    // wrong for a game you play by pointing — the pointer is attached for its
-    // position, and nothing else.
-    pointer: { lockOnClick: false },
-    debug: DEBUG,
-    // Gated on the same flag: `editor` DEFAULTS to `debug`, so a bare object
-    // here turns it on in a production build — and this file also hangs the
-    // game handle off `globalThis`, so `game.openEditor()` would be one line
-    // away in a shipped build. Every other starter gates it; this one did not.
-    editor: DEBUG && { library: true },
-  });
-  document.getElementById('loading')?.remove();
-  (globalThis as { game?: unknown }).game = game;
-} catch (error) {
-  showBootFailure(error);
-}

package/templates-app/platformer-2d/src/main.ts DELETED Viewed

@@ -1,97 +0,0 @@
-/**
- * Castle Run — a polished 2D adventure PLATFORMER on Incanto. Run a medieval
- * knight through a castle: A/D (or arrows) to run, Space/W to jump — tap again in
- * the air to DOUBLE-JUMP, and the controller forgives you with coyote-time +
- * jump-buffering. STOMP goblins from above (and chain-bounce), ride the moving
- * platform and the lift, grab coins + gems, dodge the spikes and the pit, touch
- * the Checkpoint flag so a fall sends you back there, and reach the gold flag to
- * clear the castle. Three hearts per life, three lives.
- *
- * The level is JSON: StaticBody2D platforms, Patrol/Oscillate moving platforms +
- * goblins, Pickup coins/gems, ScoreKeeper score/lives/win-lose, AudioPlayer SFX —
- * all wired in `game.scene.json`. The custom TypeScript is the game FEEL the
- * built-ins leave open: PlayerController (coyote/buffer/double-jump/variable
- * height/stomp/knockback/checkpoint-respawn/platform-carry), GoblinSkin,
- * FollowCam (follow + screen-shake), ParallaxLayer, HudUpdater.
- */
-import { createGame2D, showBootFailure } from 'incanto/2d';
-import goblinUrl from 'incanto/assets/characters/goblin.png';
-// Built-in sprite art ships in the package — import the URLs and inject them into
-// the scene's asset placeholders before boot (the engine clones the scene).
-import knightUrl from 'incanto/assets/characters/medieval-knight.png';
-import coinUrl from 'incanto/assets/items/coin.png';
-import gemUrl from 'incanto/assets/items/gem.png';
-import { FollowCam, GoblinSkin, HudUpdater, ParallaxLayer, PlayerController } from './behaviors';
-import sceneJson from './game.scene.json';
-// OPTIONAL looping music (large tracks aren't bundled). Point at any URL to loop.
-const MUSIC_URL = '';
-const behaviors = { PlayerController, GoblinSkin, FollowCam, ParallaxLayer, HudUpdater };
-const canvas = document.querySelector('canvas') as HTMLCanvasElement;
-const scene = structuredClone(sceneJson) as typeof sceneJson & {
-  assets: {
-    knight: { url: string };
-    goblin: { url: string };
-    coin: { url: string };
-    gem: { url: string };
-  };
-};
-scene.assets.knight.url = knightUrl;
-scene.assets.goblin.url = goblinUrl;
-scene.assets.coin.url = coinUrl;
-scene.assets.gem.url = gemUrl;
-/** Dev-only surfaces: the ☰ debug overlay, and the editor behind it. */
-const DEBUG = import.meta.env.VITE_INCANTO_DEBUG === '1';
-const game = await createGame2D({
-  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,
-  behaviors,
-}).catch((e) => {
-  // Without this the player watches the loading overlay sit at 100% forever:
-  // `#loading` is removed on the line below, so anything that rejects here (no
-  // WebGL context, a scene that will not load) leaves the bar up and the reason
-  // in a console nobody opens.
-  showBootFailure(e);
-  throw e;
-});
-// 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;
-// And the loading overlay comes down LAST. Everything between here and there is
-// your code; a throw in it used to leave a level that renders perfectly with no
-// player, no error UI, and no way to ask the page what happened.
-try {
-  if (MUSIC_URL) {
-    game.engine.music.play(MUSIC_URL, { loop: true, fadeIn: 1.5 });
-    game.engine.audio.music = 0.3;
-  }
-  // No hand-rolled touch button here: the scene declares `"touch": "button"` on
-  // `jump` and `"touch": "joystick"` on `move`, so the ENGINE draws both on a
-  // coarse pointer — safe-area aware, off the home-indicator band, and sized to
-  // its own rules. This template used to draw an 88 px disc of its own at a flat
-  // `bottom: 2rem`, which covered 78% of the engine's jump button and put its
-  // lower edge inside the band iOS reserves for the leave-the-app swipe.
-} catch (e) {
-  showBootFailure(e);
-  throw e;
-}
-document.querySelector('#loading')?.remove();

package/templates-app/star-survivor/src/main.ts DELETED Viewed

@@ -1,77 +0,0 @@
-/**
- * Hollow Horde — a top-down SURVIVORS-LIKE (Vampire Survivors genre) on Incanto.
- * Move with WASD / arrows; your knight AUTO-ATTACKS the nearest enemy. Goblins and
- * faster ghosts pour in from every side and grow tougher over time. Cut them down,
- * vacuum up the XP shards they drop, and on each LEVEL-UP pick one of three
- * upgrades. Survive 90 seconds to win — let the horde drain your HP and you fall.
- *
- * The horde is BUILT-IN gameplay wired in `game.scene.json`: two `Spawner`s clone
- * goblin/ghost templates, each enemy `Chase`s the player, and a `DamageOnContact`
- * hitbox drains `Health`. The custom TypeScript is the survivor FEEL the library
- * leaves open: `Survivor` (move + auto-attack + XP/level-up/upgrades + HUD),
- * `Director` (ring-spawn around the player + escalation), `EnemyDrop`, `EnemyFace`.
- */
-import { createGame2D, showBootFailure } from 'incanto/2d';
-import ghostUrl from 'incanto/assets/characters/ghost.png';
-import goblinUrl from 'incanto/assets/characters/goblin.png';
-import knightUrl from 'incanto/assets/characters/medieval-knight.png';
-import { Director, EnemyDrop, EnemyFace, GridFloor, Survivor } from './behaviors';
-import sceneJson from './game.scene.json';
-const MUSIC_URL = '';
-const behaviors = { Survivor, Director, EnemyDrop, EnemyFace, GridFloor };
-const canvas = document.querySelector('canvas') as HTMLCanvasElement;
-const scene = structuredClone(sceneJson) as typeof sceneJson & {
-  assets: { knight: { url: string }; goblin: { url: string }; ghost: { url: string } };
-};
-scene.assets.knight.url = knightUrl;
-scene.assets.goblin.url = goblinUrl;
-scene.assets.ghost.url = ghostUrl;
-/** Dev-only surfaces: the ☰ debug overlay, and the editor behind it. */
-const DEBUG = import.meta.env.VITE_INCANTO_DEBUG === '1';
-const game = await createGame2D({
-  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,
-  behaviors,
-}).catch((e) => {
-  // Without this the player watches the loading overlay sit at 100% forever:
-  // `#loading` is removed on the line below, so anything that rejects here (no
-  // WebGL context, a scene that will not load) leaves the bar up and the reason
-  // in a console nobody opens.
-  showBootFailure(e);
-  throw e;
-});
-// 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;
-// And the loading overlay comes down LAST. Everything between here and there is
-// your code; a throw in it used to leave a level that renders perfectly with no
-// player, no error UI, and no way to ask the page what happened.
-try {
-  if (MUSIC_URL) {
-    game.engine.music.play(MUSIC_URL, { loop: true, fadeIn: 1.5 });
-    game.engine.audio.music = 0.3;
-  }
-} catch (e) {
-  showBootFailure(e);
-  throw e;
-}
-document.querySelector('#loading')?.remove();

package/templates-app/tps-3d/src/main.ts DELETED Viewed

@@ -1,107 +0,0 @@
-/**
- * Vanguard — a 3D THIRD-PERSON shooter built on Incanto. Move with WASD, look
- * with the mouse (click locks the pointer), Shift to sprint, Space to jump,
- * left-click / F to fire your hitscan rifle, R to reload, Enter to restart once
- * the mission ends. The camera rides over
- * your soldier's shoulder (CharacterController3D `view: 'free'`); the crosshair
- * is where you shoot. Clear three waves of chasing enemies to SECURE THE AREA;
- * let them drain your HP to 0 and the MISSION FAILS.
- *
- * The whole loop is composed from built-in gameplay behaviors wired in
- * `game.scene.json` (third-person movement+camera, enemy AI via Chase, contact
- * damage, WaveSpawner, Health, ScoreKeeper). The only custom TypeScript is
- * `Shoot` (the click-to-fire hitscan + face-aim) and `HudUpdater` (the HUD +
- * win/lose banner).
- */
-import type { SceneJson } from 'incanto';
-import { assetUrls, preloadUrls } from 'incanto';
-import { createGame3D, showBootFailure } from 'incanto/3d';
-// A bundled clip looped as low ambience (no large music files ship in the
-// package — see incanto-audio.md). vite resolves + hashes the real file.
-import musicUrl from 'incanto/assets/audio/spells_cast.mp3';
-import { HudUpdater, Shoot } from './behaviors';
-import sceneJson from './game.scene.json';
-/**
- * The sub-scenes this scene `instance:`s — `cover.scene.json` and
- * `pillar.scene.json` — handed to the loader by path. `loadScene` never reads
- * files; vite's `import.meta.glob` gathers every scene beside this one.
- */
-const prefabs = import.meta.glob('./*.scene.json', {
-  eager: true,
-  import: 'default',
-}) as Record<string, SceneJson>;
-const resolveScene = (path: string): SceneJson | null => prefabs[`./${path}`] ?? null;
-// The soldier is a real GLB character (base-model.glb) animated by mixamo clips
-// (idle/walk/run/jump) — declared in the scene `assets`. Warm the HTTP cache with
-// a progress bar before booting; the arena, enemies, SFX + music stay zero-fetch.
-const fill = document.querySelector('#progress') as HTMLElement | null;
-const text = document.querySelector('#progress-text') as HTMLElement | null;
-await preloadUrls(assetUrls(sceneJson.assets), (done, total) => {
-  const pct = total > 0 ? Math.round((done / total) * 100) : 100;
-  if (fill) fill.style.width = `${pct}%`;
-  if (text) text.textContent = `${pct}%`;
-});
-const canvas = document.querySelector('canvas') as HTMLCanvasElement;
-// createGame3D boots everything: register (gameplay behaviors auto-registered) →
-// load → physics (auto; the scene has bodies) → keyboard + pointer-lock look →
-// renderer → start. We pass the two custom behaviors.
-/** 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: 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: sceneJson,
-  resolveScene,
-  behaviors: { Shoot, HudUpdater },
-  pointer: true, // pointer-lock mouse look (lockOnClick) — drives the free-view yaw/pitch
-}).catch((e) => {
-  // Without this the player watches the loading overlay sit at 100% forever:
-  // `#loading` is removed on the line below, so anything that rejects here (no
-  // WebGL context, a scene that will not load) leaves the bar up and the reason
-  // in a console nobody opens.
-  showBootFailure(e);
-  throw e;
-});
-// 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;
-// And the loading overlay comes down LAST. Everything between here and there is
-// your code; a throw in it used to leave a level that renders perfectly with no
-// player, no error UI, and no way to ask the page what happened.
-try {
-  // Looping background music on the music bus (a calm tense pad). The engine
-  // auto-resumes a gesture-blocked track on the first click/keypress.
-  game.engine.music.play(musicUrl, { loop: true, fadeIn: 1.5 });
-  game.engine.audio.music = 0.3;
-  // On-screen FIRE / JUMP buttons (mobile + desktop parity).
-  for (const [id, code] of [
-    ['btn-fire', 'KeyF'],
-    ['btn-jump', 'Space'],
-  ] as const) {
-    const el = document.querySelector(`#${id}`);
-    el?.addEventListener('pointerdown', () => game.engine.input.handleKey(code, true));
-    el?.addEventListener('pointerup', () => game.engine.input.handleKey(code, false));
-  }
-} catch (e) {
-  showBootFailure(e);
-  throw e;
-}
-document.querySelector('#loading')?.remove();