@skewedaspect/sage 0.7.1 → 0.8.0

package/dist/classes/level.d.ts

@@ -14,16 +14,12 @@ export interface LevelProgressEvent {
  * Levels are responsible for creating and configuring their own scenes.
  */
 export declare abstract class Level {
-    protected _name: string;
+    readonly name: string;
+    protected readonly _log: LoggerInterface;
     protected _sceneEngine?: SceneEngine;
     protected _eventBus?: GameEventBus;
     protected _scene: Scene | null;
-    protected _log: LoggerInterface;
     constructor(name: string);
-    /**
-     * The name of this level
-     */
-    get name(): string;
     /**
      * The current scene for this level (null if not loaded)
      */
@@ -35,7 +31,7 @@ export declare abstract class Level {
     /**
      * Emit a progress event during loading
      */
-    protected _emitProgress(progress: number, message: string): void;
+    protected $emitProgress(progress: number, message: string): void;
     /**
      * Load and create the scene for this level.
      * Progress events will be emitted during loading.
@@ -50,9 +46,11 @@ export declare abstract class Level {
      * Abstract method for building the scene content.
      * Concrete levels must implement this to create their specific content.
      *
+     * @param sceneEngine - The scene engine used to create the scene
+     *
      * @returns Promise that resolves to the created scene
      */
-    protected abstract buildScene(): Promise<Scene>;
+    protected abstract buildScene(sceneEngine: SceneEngine): Promise<Scene>;
     /**
      * Dispose of this level's resources
      */

package/dist/engines/scene.d.ts

@@ -6,7 +6,7 @@ export declare class SceneEngine {
     private _engine;
     private _physics;
     private _log;
-    constructor(canvas: GameCanvas, engine: AbstractEngine, physics: HavokPlugin, logger?: LoggingUtility);
+    constructor(canvas: GameCanvas, engine: AbstractEngine, physics: HavokPlugin, logger: LoggingUtility);
     /**
      * Creates a new scene with physics enabled
      * @returns A new Scene instance with physics enabled
@@ -50,7 +50,7 @@ export declare class SceneEngine {
      */
     createPointLight(name: string, position: Vector3, scene: Scene, intensity?: number): PointLight;
     /**
-     * Creates a spot light (flashlight-like lighting)
+     * Creates a spotlight (flashlight-like lighting)
      * @param name - The name for the light
      * @param position - The position of the light
      * @param direction - The direction of the light
@@ -138,21 +138,20 @@ export declare class SceneEngine {
     }): Sound;
     /**
      * Loads a 3D model/asset from a file
-     * @param rootUrl - The root URL where the file is located
      * @param sceneFilename - The filename of the scene file
      * @param scene - The scene to load the model into
      * @returns Promise that resolves with the loaded AssetContainer
      */
-    loadModel(rootUrl: string, sceneFilename: string, scene: Scene): Promise<AssetContainer>;
+    loadModel(sceneFilename: string, scene: Scene): Promise<AssetContainer>;
     /**
      * Imports meshes from a file
      * @param meshNames - Array of mesh names to import (empty array imports all)
-     * @param rootUrl - The root URL where the file is located
      * @param sceneFilename - The filename of the scene file
      * @param scene - The scene to import the meshes into
+     *
      * @returns Promise that resolves with the import result
      */
-    importMeshes(meshNames: string[], rootUrl: string, sceneFilename: string, scene: Scene): Promise<{
+    importMeshes(meshNames: string[], sceneFilename: string, scene: Scene): Promise<{
         meshes: AbstractMesh[];
         particleSystems: any[];
         skeletons: any[];

package/dist/managers/level.d.ts

@@ -14,31 +14,55 @@ export declare class LevelManager {
     private _registeredLevels;
     /** The currently active level */
     private _currentLevel;
+    /**
+     * Gets the currently active level
+     */
+    get currentLevel(): Level | null;
     constructor(eventBus: GameEventBus, sceneEngine: SceneEngine, logger?: LoggingUtility);
     /**
      * Handles level events from the event bus
      */
     private _handleLevelEvent;
+    /**
+     * Gets a loaded level by name
+     */
+    getLevel(name: string): Level | null;
     /**
      * Registers a level class that can be instantiated later
-     * @param name - The name to register the level under
      * @param level - The level class instance
      */
-    registerLevel(name: string, level: Level): void;
+    registerLevel(level: Level): void;
     /**
-     * Loads and activates a level by name
+     * Loads a level. The level must already be registered.
+     *
      * @param levelName - The name of the level to load
+     *
      * @returns Promise that resolves when the level is loaded
      */
     loadLevel(levelName: string): Promise<void>;
     /**
-     * Gets the currently active level
+     * Loads a level. The `Level` instance will be registered automatically.
+     * @param level - The Level instance to load
+     *
+     * @return Promise that resolves when the level is loaded
      */
-    get currentLevel(): Level | null;
+    loadLevel(level: Level): Promise<void>;
     /**
-     * Gets a loaded level by name
+     * Activates a level by name, loading it if necessary. The level must already be registered.
+     *
+     * @param levelName - The name of the level to activate
+     *
+     * @returns Promise that resolves when the level is activated.
      */
-    getLevel(name: string): Level | null;
+    activateLevel(levelName: string): Promise<void>;
+    /**
+     * Activates a level, loading it if necessary. The `Level` instance will be registered automatically.
+     *
+     * @param level - The Level instance to activate
+     *
+     * @returns Promise that resolves when the level is activated.
+     */
+    activateLevel(level: Level): Promise<void>;
     /**
      * Unloads a level and disposes its resources
      */

package/dist/sage.d.ts

@@ -1,6 +1,7 @@
 import { GameCanvas, RenderEngineOptions, SageOptions } from "./interfaces/game.d.ts";
 import { SkewedAspectGameEngine } from "./classes/gameEngine.d.ts";
 import { GameEventBus } from "./classes/eventBus.d.ts";
+import { SceneEngine } from "./engines/scene.d.ts";
 import { GameEntityDefinition } from "./interfaces/entity.d.ts";
 /**
  * Creates an instance of SkewedAspectGameEngine.
@@ -17,7 +18,7 @@ export * from "./interfaces/entity.d.ts";
 export * from "./interfaces/game.d.ts";
 export * from "./interfaces/input.d.ts";
 export * from "./interfaces/logger.d.ts";
-export { GameEventBus, SkewedAspectGameEngine };
+export { GameEventBus, SkewedAspectGameEngine, SceneEngine };
 export * from "./classes/eventBus.d.ts";
 export * from "./classes/entity.d.ts";
 export * from "./classes/level.d.ts";