incanto 0.76.0 → 0.78.0

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

@@ -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

@@ -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();

package/templates-app/village-quest-3d/src/main.ts

@@ -1,62 +0,0 @@
-/**
- * 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 { BEHAVIORS } from './behaviors';
-import villageJson from './village.scene.json';
-
-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}%`;
-});
-
-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: 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();