@skewedaspect/sage 0.9.1 → 0.9.3

package/dist/classes/debugConsole.d.ts

@@ -0,0 +1,22 @@
+import { Disposable } from "../interfaces/lifecycle.d.ts";
+interface DynamicGetter {
+    get: () => unknown;
+}
+export declare class DebugConsole implements Disposable {
+    private _namespaceName;
+    private _entries;
+    private _disposed;
+    constructor(namespaceName?: string);
+    expose(name: string, value: unknown | DynamicGetter): void;
+    setNamespace(name: string): void;
+    get namespaceName(): string;
+    dispose(): void;
+    $teardown(): Promise<void>;
+    private _isDynamicGetter;
+    private _getNamespace;
+    private _installNamespace;
+    private _removeNamespace;
+    private _defineGetter;
+    private _defineValue;
+}
+export {};

package/dist/classes/entity.d.ts

@@ -1,6 +1,7 @@
 import { TransformNode } from '@babylonjs/core';
 import { GameEntityBehaviorConstructor } from "../interfaces/entity.d.ts";
 import { Destroyable } from "../interfaces/lifecycle.d.ts";
+import { ColliderDebugConfig } from "../managers/colliderDebug.d.ts";
 import { GameEvent, GameEventBus } from "./eventBus.d.ts";
 import { GameEngine } from "./gameEngine.d.ts";
 /**
@@ -201,6 +202,26 @@ export declare class GameEntity<EntityState extends object = object> implements
      * @param layerName - Specific layer to remove from, or omit to remove from all
      */
     unhighlight(layerName?: string): void;
+    /**
+     * Shows collider debug visualization for this entity's physics nodes.
+     *
+     * Overloads:
+     * - `showCollider()` — show all colliders, default color
+     * - `showCollider(true)` — show all colliders, default color (config-driven)
+     * - `showCollider('#ff0000')` — show all colliders with a specific color
+     * - `showCollider('head')` — show a specific collider by node name
+     * - `showCollider('head', '#ff0000')` — show a specific collider by name with color
+     * - `showCollider({ head: '#ff0000', body: false })` — per-collider control
+     */
+    showCollider(configOrNameOrColor?: ColliderDebugConfig, color?: string): void;
+    /**
+     * Hides collider debug visualization for this entity's physics nodes.
+     *
+     * - `hideCollider()` — hide all colliders
+     * - `hideCollider('head')` — hide a specific collider by node name
+     */
+    hideCollider(name?: string): void;
+    private _getPhysicsNodes;
     /**
      * Adds a child entity to this entity's hierarchy.
      * Sets the child's parent to this entity. If both entities have nodes, parents the child's node.

package/dist/classes/gameEngine.d.ts

@@ -5,6 +5,8 @@ import { SceneEngine } from "../engines/scene.d.ts";
 import { AudioEngine } from "../engines/audio.d.ts";
 import { AssetManager } from "../managers/asset.d.ts";
 import { BindingManager } from "../managers/binding.d.ts";
+import { ColliderDebugManager } from "../managers/colliderDebug.d.ts";
+import { DebugConsole } from "./debugConsole.d.ts";
 import { GameManager } from "../managers/game.d.ts";
 import { GameEntityManager } from "../managers/entity.d.ts";
 import { LevelManager } from "../managers/level.d.ts";
@@ -43,6 +45,14 @@ interface Managers extends Record<string, Disposable | undefined> {
     saveManager: SaveManager;
     audioManager?: AudioManager;
 }
+/**
+ * Interface representing the debug tools available on the engine.
+ */
+interface DebugTools {
+    colliders: ColliderDebugManager;
+    console: DebugConsole | null;
+    expose(name: string, value: unknown): void;
+}
 /**
  * Central hub that owns the render loop, physics, event bus, and all managers.
  * Created via `createGameEngine()` in sage.ts.
@@ -57,6 +67,7 @@ export declare class GameEngine {
     logger: LoggingUtility;
     raycast: RaycastHelper;
     timer: GameTimer;
+    debug: DebugTools;
     largeWorldRendering: boolean;
     started: boolean;
     private _log;
@@ -73,7 +84,7 @@ export declare class GameEngine {
      * @param engines
      * @param managers
      */
-    constructor(canvas: GameCanvas, renderEngine: AbstractEngine, physics: HavokPlugin, eventBus: GameEventBus, logger: LoggingUtility, raycast: RaycastHelper, timer: GameTimer, engines: Engines, managers: Managers, largeWorldRendering?: boolean);
+    constructor(canvas: GameCanvas, renderEngine: AbstractEngine, physics: HavokPlugin, eventBus: GameEventBus, logger: LoggingUtility, raycast: RaycastHelper, timer: GameTimer, engines: Engines, managers: Managers, largeWorldRendering?: boolean, debug?: DebugTools);
     /**
      * Register a function to be called before the game engine starts
      * @param hook

package/dist/classes/gameLevel.d.ts

@@ -3,7 +3,9 @@ import { LevelConfig, LevelContext } from "../interfaces/level.d.ts";
 import { GameEntity } from "./entity.d.ts";
 import { Level } from "./level.d.ts";
 /**
- * Metadata collected from a spawn point node
+ * Metadata collected from a spawn point node.
+ * Transforms are normalized to canonical Babylon space — the source level's __root__
+ * conversion is removed so these values are clean for any entity type.
  */
 interface SpawnPointData {
     name: string;
@@ -133,6 +135,11 @@ export declare class GameLevel extends Level {
      * Spawn an entity at the given spawn point and dispose of the placeholder node.
      */
     private _processSpawnPoint;
+    /**
+     * Apply debug collider visualization to an entity if configured.
+     * Level/spawn config takes priority over the entity definition's debugCollider.
+     */
+    private _applyDebugCollider;
     /**
      * Create an entity from a spawn definition, inheriting position/rotation/scaling from the spawn point.
      */

package/dist/debug/builtins.d.ts

@@ -0,0 +1,6 @@
+import { DebugConsole } from "../classes/debugConsole.d.ts";
+import { GameEngine } from "../classes/gameEngine.d.ts";
+/**
+ * Registers all default references and commands onto the debug console namespace.
+ */
+export declare function registerBuiltins(dc: DebugConsole, ge: GameEngine): void;

package/dist/interfaces/entity.d.ts

@@ -1,5 +1,6 @@
 import { GameEntityBehavior } from "../classes/entity.d.ts";
 import { Action } from "./action.d.ts";
+import { ColliderDebugConfig } from "../managers/colliderDebug.d.ts";
 export type GameEntityBehaviorConstructor<RequiredState extends object = object> = new () => GameEntityBehavior<RequiredState>;
 export interface GameEntityDefinition<State extends object = object> {
     /** Unique type identifier for this entity definition. */
@@ -85,6 +86,8 @@ export interface GameEntityDefinition<State extends object = object> {
             z: number;
         };
     }[];
+    /** Debug collider visualization config. Applied automatically during level loading. */
+    debugCollider?: ColliderDebugConfig;
     onBeforeCreate?: (state: State) => Promise<State | undefined> | State | undefined;
     onCreate?: (state: State) => Promise<State | undefined> | State | undefined;
     onBeforeDestroy?: (state: State) => Promise<State | undefined> | State | undefined;

package/dist/interfaces/game.d.ts

@@ -31,4 +31,13 @@ export interface SageOptions {
      * Also enables multi-region Havok physics when physics are active.
      */
     largeWorldRendering?: boolean;
+    /**
+     * Debug console configuration.
+     * - `true` or omitted: enabled with default namespace 'sage'
+     * - `{ namespace: 'myGame' }`: enabled with custom namespace
+     * - `false`: disabled (production builds)
+     */
+    debug?: false | {
+        namespace?: string;
+    };
 }

package/dist/interfaces/level.d.ts

@@ -1,5 +1,6 @@
 import { Scene, TransformNode } from '@babylonjs/core';
 import { GameEngine } from "../classes/gameEngine.d.ts";
+import { ColliderDebugConfig } from "../managers/colliderDebug.d.ts";
 import { LoggingUtility } from "../utils/logger.d.ts";
 /**
  * Minimal interface for Level that property handlers receive.
@@ -42,6 +43,8 @@ export interface SpawnDefinition {
     tags?: string[];
     /** Additional configuration passed to the entity's initial state */
     config?: Record<string, unknown>;
+    /** Debug collider visualization config. Overrides the entity definition's debugCollider. */
+    debugCollider?: ColliderDebugConfig;
 }
 /**
  * Definition for entity types found in the scene.
@@ -54,6 +57,8 @@ export interface EntityDefinition {
     tags?: string[];
     /** Additional configuration passed to the entity's initial state */
     config?: Record<string, unknown>;
+    /** Debug collider visualization config. Overrides the entity definition's debugCollider. */
+    debugCollider?: ColliderDebugConfig;
 }
 /**
  * Configuration for loading a scene file.

package/dist/managers/colliderDebug.d.ts

@@ -0,0 +1,16 @@
+import { TransformNode } from '@babylonjs/core';
+import { Disposable } from "../interfaces/lifecycle.d.ts";
+export type ColliderDebugConfig = boolean | string | Record<string, string | false>;
+export declare class ColliderDebugManager implements Disposable {
+    private _viewer;
+    private _shown;
+    private _materials;
+    showColliderForNode(node: TransformNode, color?: string): void;
+    hideColliderForNode(node: TransformNode): void;
+    hideAll(): void;
+    isShown(node: TransformNode): boolean;
+    $teardown(): Promise<void>;
+    dispose(): void;
+    private _getViewer;
+    private _getColorMaterial;
+}

package/dist/sage.d.ts

@@ -38,11 +38,15 @@ export type { CreateEntityOptions } from "./managers/entity.d.ts";
 export type { TransitionOptions } from "./managers/level.d.ts";
 export { AudioManager } from "./managers/audio.d.ts";
 export type { ChannelInfo } from "./managers/audio.d.ts";
+export { ColliderDebugManager } from "./managers/colliderDebug.d.ts";
+export type { ColliderDebugConfig } from "./managers/colliderDebug.d.ts";
 export { OutlineManager } from "./managers/outline.d.ts";
 export { SaveManager } from "./managers/save.d.ts";
 export type { SaveData, SerializedEntity } from "./managers/save.d.ts";
+export { DebugConsole } from "./classes/debugConsole.d.ts";
+export { createEntityProxy } from "./utils/entityProxy.d.ts";
 export { generateId } from "./utils/id.d.ts";
 export { RaycastHelper } from "./utils/raycast.d.ts";
 export type { EntityPickResult, EntityPickFilter } from "./utils/raycast.d.ts";
 export { StateMachine } from "./utils/stateMachine.d.ts";
-export { toVec3Object, toVector3, toQuatObject, toQuaternion } from "./utils/vectors.d.ts";
+export { getCanonicalTransform, toQuatObject, toQuaternion, toVec3Object, toVector3, } from "./utils/vectors.d.ts";