@skewedaspect/sage 0.11.0 → 0.13.0

package/dist/classes/level.d.ts

@@ -50,6 +50,11 @@ export declare abstract class Level<Registry extends NodeEntityRegistry = NodeEn
      * into a fresh one (design/simulation.md#saved-games).
      */
     $adoptSimulation(simulation: NodeSimulation<Registry>): void;
+    /**
+     * Builds an empty scene through the scene engine and makes it this level's scene at once
+     * (design/levels.md#the-base-class).
+     */
+    protected createScene(): Scene;
     /**
      * Builds this level's simulation for the scene it just created, named after the level, and keeps it. A
      * subclass calls this from `buildScene` before it spawns anything, since a NodeEntity constructs its node

package/dist/managers/asset.d.ts

@@ -3,6 +3,10 @@ import { EventBus } from '@skewedaspect/sage-core';
 import { SceneEngine } from "../engines/scene.js";
 import { Disposable } from "../interfaces/lifecycle.js";
 import { LoggingUtility } from "../utils/logger.js";
+/** How `instantiate` copies a file's meshes (design/engine.md#the-asset-manager). */
+export interface InstantiateOptions {
+    instances?: boolean;
+}
 /**
  * Central asset cache with preloading, GLB fragment extraction, mesh instancing, and reference counting.
  *
@@ -79,9 +83,10 @@ export declare class AssetManager implements Disposable {
     clone(path: string, into: Scene): Mesh;
     /**
      * Copies a whole file into the scene it is handed: every mesh and node, with the file's skeletons and animation
-     * groups. The meshes are cloned and share the container's materials. The copy is the caller's to dispose.
+     * groups. The meshes are cloned and share the container's materials, or, given `instances`, every mesh Babylon
+     * can instance is an instance of the container's. The copy is the caller's to dispose.
      */
-    instantiate(path: string, scene: Scene): Promise<InstantiatedEntries>;
+    instantiate(path: string, scene: Scene, options?: InstantiateOptions): Promise<InstantiatedEntries>;
     /**
      * Preload a batch of asset paths, up to `MAX_CONCURRENT_LOADS` at a time, so a batch costs about as
      * long as its slowest asset rather than the sum of them all.

package/dist/managers/level.d.ts

@@ -95,6 +95,11 @@ export declare class LevelManager<Registry extends NodeEntityRegistry = NodeEnti
     /** The level loaded under this name, or nothing when none is loaded under it. */
     getLevel(name: string): Level<Registry> | null;
     /** The configuration registered under this name, or nothing when none is. */
+    /**
+     * Unloads the level registered under the name if it is loaded, then forgets its configuration
+     * (design/levels.md#configurations-and-classes).
+     */
+    unregisterLevelConfig(name: string): Promise<void>;
     getLevelConfig(name: string): LevelConfig | null;
     /**
      * Loads the level a registered name points at, or the one a configuration carries, registering that

package/dist/sage.d.ts

@@ -19,6 +19,7 @@ export declare function createGameEngine<Registry extends NodeEntityRegistry = N
 export * from "./interfaces/game.js";
 export * from "./interfaces/logger.js";
 export { AssetManager, AudioEngine, GameEngine, GameManager, LevelManager, SceneEngine };
+export type { InstantiateOptions } from "./managers/asset.js";
 export type { DebugTools, Engines, GameHook, Managers, RebuildSimulationOptions, SimulationFactory, } from "./classes/gameEngine.js";
 export * from "./classes/level.js";
 export * from "./classes/gameLevel.js";