@skewedaspect/sage 0.12.0 → 0.13.0

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/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";

package/dist/sage.es.js

@@ -68,7 +68,7 @@ var He = class {
 			configurable: !0
 		});
 	}
-}, j = "0.12.0", Ue = class e {
+}, j = "0.13.0", Ue = class e {
 	canvas;
 	renderEngine;
 	managers;
@@ -920,15 +920,15 @@ var dt = class {
 		});
 		return r.metadata = null, r;
 	}
-	async instantiate(e, t) {
-		let { basePath: n, fragment: r } = this._parsePath(e);
-		if (r) throw Error(`Cannot instantiate '${e}': the fragment '${r}' is one mesh. clone() copies one mesh.`);
-		let i = (await this._containerForScene(n, t)).instantiateModelsToScene(void 0, !1, { doNotInstantiate: !0 });
-		for (let e of i.rootNodes) {
+	async instantiate(e, t, n) {
+		let { basePath: r, fragment: i } = this._parsePath(e);
+		if (i) throw Error(`Cannot instantiate '${e}': the fragment '${i}' is one mesh. clone() copies one mesh.`);
+		let a = await this._containerForScene(r, t), o = n?.instances ?? !1, s = a.instantiateModelsToScene(void 0, !1, { doNotInstantiate: !o });
+		for (let e of s.rootNodes) {
 			e.metadata = null;
 			for (let t of e.getDescendants()) t.metadata = null;
 		}
-		return i;
+		return s;
 	}
 	async preload(e) {
 		let t = e.length, n = [], r = 0, i = 0, a = async () => {