@skewedaspect/sage 0.9.6 → 0.10.0-beta.2

package/dist/managers/input.d.ts

@@ -1,54 +1,34 @@
-import { InputDevice } from "../interfaces/input.d.ts";
+import { GameSimulationContext, Unsubscribe } from '@skewedaspect/sage-core';
 import { Disposable } from "../interfaces/lifecycle.d.ts";
-import { GameEventBus } from "../classes/eventBus.d.ts";
-import { LoggingUtility } from "../utils/logger.d.ts";
-/**
- * Manager for handling user input from various devices (keyboard, mouse, gamepad)
- */
-export declare class UserInputManager implements Disposable {
-    private _eventBus;
-    private _keyboardRA;
-    private _mouseRA;
-    private _gamepadRA;
-    /** Logger instance */
-    private _log;
-    /**
-     * Create a new UserInputManager.
-     *
-     * @param eventBus
-     * @param canvas - The DOM element to attach input listeners to (used by mouse input)
-     * @param logger
-     */
-    constructor(eventBus: GameEventBus, canvas: HTMLElement, logger?: LoggingUtility);
-    /**
-     * Publish device connected event to the event bus
-     */
-    private _publishDeviceConnected;
-    /**
-     * Publish device disconnected event to the event bus
-     */
-    private _publishDeviceDisconnected;
-    /**
-     * Publish input changed event to the event bus, used by all device types
-     */
-    private _publishInputChanged;
-    /**
-     * Tears down the input manager and clean up event listeners
-     */
+import { Binding, DeviceType } from "../input/binding.d.ts";
+import { InputCapture } from "../input/inputCapture.d.ts";
+import { GamepadState, KeyboardState, MouseState } from "../input/deviceState.d.ts";
+import { ActionContextRegistry } from "../input/actionContext.d.ts";
+import { ActionRegistry } from "../input/actionRegistry.d.ts";
+declare module '@skewedaspect/sage-core' {
+    interface EventMap {
+        'input:deviceChanged': DeviceChangedPayload;
+    }
+}
+export interface DeviceChangedPayload {
+    deviceType: DeviceType;
+    /** Undefined for the first deliberate input of a session, which replaces no device type. */
+    previousDeviceType: DeviceType | undefined;
+}
+export declare const ROUTING_LOOP_SENDER_ID = "sage-input";
+export declare const DELIBERATE_THRESHOLD = 0.2;
+export declare const MOVEMENT_THRESHOLD = 2;
+export declare class InputManager implements Disposable {
+    #private;
+    readonly actions: ActionRegistry;
+    readonly contexts: ActionContextRegistry;
+    constructor();
+    get lastActiveDeviceType(): DeviceType | undefined;
+    deviceState(type: 'keyboard', index: number): KeyboardState;
+    deviceState(type: 'mouse', index: number): MouseState;
+    deviceState(type: 'gamepad', index: number): GamepadState;
+    registerCapture(capture: InputCapture): Unsubscribe;
+    getBindingsForAction(action: string, deviceType?: DeviceType, context?: string): readonly Binding<unknown>[];
+    routeCapturedInput(context: GameSimulationContext): void;
     $teardown(): Promise<void>;
-    /**
-     * Get all connected input devices (keyboard, mouse, and any gamepads).
-     */
-    listDevices(): InputDevice[];
-    /**
-     * Get a specific input device by ID.
-     * Uses device ID prefix (keyboard-, mouse-, gamepad-) for fast lookup.
-     *
-     * @param deviceId
-     */
-    getDevice(deviceId: string): InputDevice | null;
-    /**
-     * Poll for gamepad state updates - call this in your game loop
-     */
-    pollGamepads(): void;
 }

package/dist/managers/level.d.ts

@@ -1,13 +1,14 @@
-import { LevelConfig, LevelConstructor, PropertyHandler } from "../interfaces/level.d.ts";
+import { LevelConfig, LevelConstructor, LevelLoadOptions, PropertyHandler } from "../interfaces/level.d.ts";
 import { Disposable } from "../interfaces/lifecycle.d.ts";
 import { Level } from "../classes/level.d.ts";
 import { GameEventBus } from "../classes/eventBus.d.ts";
 import { GameEngine } from "../classes/gameEngine.d.ts";
+import { NodeSimulation } from "../entities/nodeSimulation.d.ts";
 import { LoggingUtility } from "../utils/logger.d.ts";
 /**
  * Options for level transitions.
  */
-export interface TransitionOptions {
+export interface TransitionOptions extends LevelLoadOptions {
     /** If true, the old level is kept loaded (not disposed) after transitioning away */
     keepAlive?: boolean;
     /** If true, the new level is loaded but not activated — currentLevel remains unchanged */
@@ -137,14 +138,29 @@ export declare class LevelManager implements Disposable {
      * Loads a level by name. The level config must be registered first.
      *
      * @param name
+     * @param options
      */
-    loadLevel(name: string): Promise<Level>;
+    loadLevel(name: string, options?: LevelLoadOptions): Promise<Level>;
     /**
      * Loads a level from a config. The config will be registered automatically.
      *
      * @param config
+     * @param options
+     */
+    loadLevel(config: LevelConfig, options?: LevelLoadOptions): Promise<Level>;
+    /**
+     * Bind the engine to a level's own simulation. A level that built none leaves the engine as it is.
+     *
+     * @param level
+     */
+    private _bindSimulation;
+    /**
+     * Hand the current level a simulation built to replace its own, and bind the engine to it. A save load
+     * restores into a fresh simulation, and the level that owns the scene has to follow it.
+     *
+     * @param simulation
      */
-    loadLevel(config: LevelConfig): Promise<Level>;
+    $bindSimulation(simulation: NodeSimulation): void;
     /**
      * Activates a level by name, loading it if necessary.
      *

package/dist/managers/outline.d.ts

@@ -1,5 +1,5 @@
 import { Scene, SelectionOutlineLayer } from '@babylonjs/core';
-import { GameEntity } from "../classes/entity.d.ts";
+import { NodeEntity } from "../entities/nodeEntity.d.ts";
 import { OutlineLayerConfig } from "../interfaces/level.d.ts";
 export declare class OutlineManager {
     private _scene;
@@ -7,9 +7,9 @@ export declare class OutlineManager {
     constructor(scene: Scene, configs?: Record<string, OutlineLayerConfig>);
     get(name: string): SelectionOutlineLayer | undefined;
     create(name: string, config?: OutlineLayerConfig): SelectionOutlineLayer;
-    highlightEntity(layerName: string, entity: GameEntity): void;
-    unhighlightEntity(layerName: string, entity: GameEntity): void;
-    unhighlightEntityAll(entity: GameEntity): void;
+    highlightEntity(layerName: string, entity: NodeEntity): void;
+    unhighlightEntity(layerName: string, entity: NodeEntity): void;
+    unhighlightEntityAll(entity: NodeEntity): void;
     clear(layerName: string): void;
     dispose(): void;
     private _rebuildSelection;

package/dist/managers/simulationSave.d.ts

@@ -0,0 +1,38 @@
+import { GameSimulationManager, GameSimulationSnapshot } from '@skewedaspect/sage-core';
+import { GameEngine } from "../classes/gameEngine.d.ts";
+import { NodeSimulation } from "../entities/nodeSimulation.d.ts";
+import { Disposable } from "../interfaces/lifecycle.d.ts";
+import { LevelLoadOptions } from "../interfaces/level.d.ts";
+export interface LevelLoader {
+    readonly currentLevel: {
+        name: string;
+    } | null;
+    transition(levelName: string, options?: LevelLoadOptions): Promise<void>;
+    $bindSimulation(simulation: NodeSimulation): void;
+}
+export interface SaveEnvelope {
+    saveFormatVersion: number;
+    engineVersion: string;
+    level: string;
+    timestamp: number;
+    custom: Record<string, unknown>;
+    snapshot: GameSimulationSnapshot;
+}
+export type BeforeSaveHook = () => Record<string, unknown>;
+export interface LoadResult {
+    simulation: NodeSimulation;
+    envelope: SaveEnvelope;
+}
+export declare class SimulationSaveManager implements Disposable {
+    #private;
+    constructor(levelLoader: LevelLoader, engineVersion: string, now?: () => number);
+    /**
+     * Late-bind the GameEngine after construction. Called by createGameEngine() after the GameEngine
+     * instance is created; load() needs it to reach the simulation a transition just rebuilt.
+     */
+    $setGameEngine(gameEngine: GameEngine): void;
+    onBeforeSave(hook: BeforeSaveHook): void;
+    save(simulation: GameSimulationManager): SaveEnvelope;
+    load(envelope: SaveEnvelope): Promise<LoadResult>;
+    $teardown(): Promise<void>;
+}

package/dist/{postProcessingFrameGraph-CaMgQzR-.js → postProcessingFrameGraph-C3Og4kaS.js}

@@ -10,61 +10,69 @@ var p = {
 async function m(m, h) {
 	let g = m.activeCamera;
 	if (!g) return;
-	let _ = m.getEngine(), v = new t(m), y = v.textureManager.createRenderTargetTexture("sage-fg-color", {
-		size: {
-			width: 100,
-			height: 100
-		},
-		sizeIsPercentage: !0,
-		options: {
-			formats: [e.TEXTUREFORMAT_RGBA],
-			samples: 4
-		}
-	}), b = new i("sage-clear", v);
-	b.targetTexture = y, v.addTask(b);
-	let x = new l("sage-render", v, m);
-	x.targetTexture = b.outputTexture, x.depthTexture = b.outputDepthTexture, x.camera = g, x.objectList = {
+	let _ = m.getEngine(), v = new t(m);
+	function y(e, t) {
+		return v.textureManager.createRenderTargetTexture(e, {
+			size: {
+				width: 100,
+				height: 100
+			},
+			sizeIsPercentage: !0,
+			options: {
+				formats: [t],
+				samples: 4
+			}
+		});
+	}
+	let b = y("sage-fg-color", e.TEXTUREFORMAT_RGBA), x = y("sage-fg-depth", e.TEXTUREFORMAT_DEPTH24_STENCIL8), S = new i("sage-clear", v);
+	S.targetTexture = b, S.depthTexture = x, S.clearDepth = !0, S.clearStencil = !0, v.addTask(S);
+	let C = new l("sage-render", v, m);
+	C.targetTexture = S.outputTexture, C.depthTexture = S.outputDepthTexture, C.camera = g, C.objectList = {
 		meshes: m.meshes,
 		particleSystems: m.particleSystems
-	}, x.isMainObjectRenderer = !0, v.addTask(x);
-	let S = x.outputTexture;
+	}, C.isMainObjectRenderer = !0, v.addTask(C);
+	let w = C.outputTexture;
 	if (h.ssao) {
 		let e = new o("sage-geometry", v, m);
 		v.addTask(e);
 		let t = new u("sage-ssao", v, .5, 1);
-		t.sourceTexture = S, t.depthTexture = e.geometryViewDepthTexture, t.normalTexture = e.geometryViewNormalTexture, t.camera = g, v.addTask(t), h.ssao.radius !== void 0 && (t.ssao.radius = h.ssao.radius), h.ssao.samples !== void 0 && (t.ssao.samples = h.ssao.samples), h.ssao.totalStrength !== void 0 && (t.ssao.totalStrength = h.ssao.totalStrength), S = t.outputTexture;
+		t.sourceTexture = w, t.depthTexture = e.geometryViewDepthTexture, t.normalTexture = e.geometryViewNormalTexture, t.camera = g, v.addTask(t), h.ssao.radius !== void 0 && (t.ssao.radius = h.ssao.radius), h.ssao.samples !== void 0 && (t.ssao.samples = h.ssao.samples), h.ssao.totalStrength !== void 0 && (t.ssao.totalStrength = h.ssao.totalStrength), w = t.outputTexture;
 	}
 	if (h.bloom) {
 		let e = new n("sage-bloom", v, h.bloom.weight ?? .5, h.bloom.kernel ?? 128, h.bloom.threshold ?? .1, !0, h.bloom.scale ?? .5);
-		e.sourceTexture = S, v.addTask(e), S = e.outputTexture;
+		e.sourceTexture = w, v.addTask(e), w = e.outputTexture;
 	}
 	if (h.grain) {
 		let e = new s("sage-grain", v);
-		e.sourceTexture = S, v.addTask(e), h.grain.intensity !== void 0 && (e.postProcess.intensity = h.grain.intensity), h.grain.animated !== void 0 && (e.postProcess.animated = h.grain.animated), S = e.outputTexture;
+		e.sourceTexture = w, v.addTask(e), h.grain.intensity !== void 0 && (e.postProcess.intensity = h.grain.intensity), h.grain.animated !== void 0 && (e.postProcess.animated = h.grain.animated), w = e.outputTexture;
 	}
 	if (h.sharpen) {
 		let e = new d("sage-sharpen", v);
-		e.sourceTexture = S, v.addTask(e), h.sharpen.edge !== void 0 && (e.postProcess.edgeAmount = h.sharpen.edge), h.sharpen.color !== void 0 && (e.postProcess.colorAmount = h.sharpen.color), S = e.outputTexture;
+		e.sourceTexture = w, v.addTask(e), h.sharpen.edge !== void 0 && (e.postProcess.edgeAmount = h.sharpen.edge), h.sharpen.color !== void 0 && (e.postProcess.colorAmount = h.sharpen.color), w = e.outputTexture;
 	}
 	if (h.chromaticAberration) {
 		let e = new r("sage-chromab", v);
-		e.sourceTexture = S, v.addTask(e), h.chromaticAberration.amount !== void 0 && (e.postProcess.aberrationAmount = h.chromaticAberration.amount), S = e.outputTexture;
+		e.sourceTexture = w, v.addTask(e), h.chromaticAberration.amount !== void 0 && (e.postProcess.aberrationAmount = h.chromaticAberration.amount), w = e.outputTexture;
 	}
 	if (h.tonemap || h.vignette) {
 		let e = new c("sage-imgproc", v);
-		if (e.sourceTexture = S, v.addTask(e), h.tonemap && (e.postProcess.toneMappingEnabled = !0, h.tonemap.operator && (e.postProcess.toneMappingType = p[h.tonemap.operator] ?? f.TONEMAPPING_STANDARD)), h.vignette && (e.postProcess.vignetteEnabled = !0, h.vignette.weight !== void 0 && (e.postProcess.vignetteWeight = h.vignette.weight), h.vignette.stretch !== void 0 && (e.postProcess.vignetteStretch = h.vignette.stretch), h.vignette.color)) {
+		if (e.sourceTexture = w, v.addTask(e), h.tonemap && (e.postProcess.toneMappingEnabled = !0, h.tonemap.operator && (e.postProcess.toneMappingType = p[h.tonemap.operator] ?? f.TONEMAPPING_STANDARD)), h.vignette && (e.postProcess.vignetteEnabled = !0, h.vignette.weight !== void 0 && (e.postProcess.vignetteWeight = h.vignette.weight), h.vignette.stretch !== void 0 && (e.postProcess.vignetteStretch = h.vignette.stretch), h.vignette.color)) {
 			let t = h.vignette.color;
 			e.postProcess.vignetteColor.set(t.r, t.g, t.b, 1);
 		}
-		S = e.outputTexture;
+		w = e.outputTexture;
 	}
 	h.volumetric && console.warn("[SAGE] Volumetric lighting config is recognized but automatic light detection is not yet supported. Use scene.frameGraph to add FrameGraphVolumetricLightingTask manually.");
-	let C = new a("sage-output", v);
-	C.sourceTexture = S, v.addTask(C), m.cameraToUseForPointers = g, m.frameGraph = v, _.onResizeObservable.add(async () => {
+	let T = new a("sage-output", v);
+	T.sourceTexture = w, v.addTask(T), m.cameraToUseForPointers = g, m.frameGraph = v;
+	let E = _.onResizeObservable.add(async () => {
 		await v.buildAsync();
+	});
+	m.onDisposeObservable.addOnce(() => {
+		_.onResizeObservable.remove(E);
 	}), await v.buildAsync();
 }
 //#endregion
 export { m as applyFrameGraphPostProcessing };
 
-//# sourceMappingURL=postProcessingFrameGraph-CaMgQzR-.js.map
+//# sourceMappingURL=postProcessingFrameGraph-C3Og4kaS.js.map

package/dist/postProcessingFrameGraph-C3Og4kaS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postProcessingFrameGraph-C3Og4kaS.js","names":[],"sources":["../src/handlers/postProcessingFrameGraph.ts"],"sourcesContent":["//----------------------------------------------------------------------------------------------------------------------\n// Frame Graph Post-Processing Backend\n//\n// Builds a directed task chain using BabylonJS Frame Graph system.\n// Each post-processing effect is a separate task chained via texture handles.\n//----------------------------------------------------------------------------------------------------------------------\n\nimport {\n    Constants,\n    FrameGraph,\n    FrameGraphBloomTask,\n    FrameGraphChromaticAberrationTask,\n    FrameGraphClearTextureTask,\n    FrameGraphCopyToBackbufferColorTask,\n    FrameGraphGeometryRendererTask,\n    FrameGraphGrainTask,\n    FrameGraphImageProcessingTask,\n    FrameGraphObjectRendererTask,\n    FrameGraphSSAO2RenderingPipelineTask,\n    FrameGraphSharpenTask,\n    type FrameGraphTextureHandle,\n    ImageProcessingConfiguration,\n    type Scene,\n} from '@babylonjs/core';\n\nimport type { PostProcessingConfig } from '../interfaces/level.ts';\n\n//----------------------------------------------------------------------------------------------------------------------\n\n/**\n * Map from user-facing tonemap operator names to BabylonJS constants.\n * BabylonJS only has STANDARD (0) and ACES (1) — the other names all map to STANDARD.\n */\nconst TONEMAP_OPERATORS : Record<string, number> = {\n    hable: ImageProcessingConfiguration.TONEMAPPING_STANDARD,\n    reinhard: ImageProcessingConfiguration.TONEMAPPING_STANDARD,\n    hejidawson: ImageProcessingConfiguration.TONEMAPPING_STANDARD,\n    photographic: ImageProcessingConfiguration.TONEMAPPING_STANDARD,\n    aces: ImageProcessingConfiguration.TONEMAPPING_ACES,\n};\n\n//----------------------------------------------------------------------------------------------------------------------\n\nexport async function applyFrameGraphPostProcessing(scene : Scene, config : PostProcessingConfig) : Promise<void>\n{\n    const camera = scene.activeCamera;\n    if(!camera)\n    {\n        return;\n    }\n\n    const engine = scene.getEngine();\n    const fg = new FrameGraph(scene);\n\n    // The color target and its depth attachment differ only in format: the object renderer checks that\n    // their size and sample count agree when the graph builds.\n    function createTarget(name : string, format : number) : FrameGraphTextureHandle\n    {\n        return fg.textureManager.createRenderTargetTexture(name, {\n            size: { width: 100, height: 100 },\n            sizeIsPercentage: true,\n            options: { formats: [ format ], samples: 4 },\n        });\n    }\n\n    const colorTexture = createTarget('sage-fg-color', Constants.TEXTUREFORMAT_RGBA);\n    const depthTexture = createTarget('sage-fg-depth', Constants.TEXTUREFORMAT_DEPTH24_STENCIL8);\n\n    // 1. Clear. The clear task resolves its outputDepthTexture handle only when it is given a depth texture\n    // to clear; the object renderer below reads that handle, and an unresolved one has no texture behind it.\n    const clearTask = new FrameGraphClearTextureTask('sage-clear', fg);\n    clearTask.targetTexture = colorTexture;\n    clearTask.depthTexture = depthTexture;\n    clearTask.clearDepth = true;\n    clearTask.clearStencil = true;\n    fg.addTask(clearTask);\n\n    // 2. Render objects\n    const renderTask = new FrameGraphObjectRendererTask('sage-render', fg, scene);\n    renderTask.targetTexture = clearTask.outputTexture;\n    renderTask.depthTexture = clearTask.outputDepthTexture;\n    renderTask.camera = camera;\n    renderTask.objectList = { meshes: scene.meshes, particleSystems: scene.particleSystems };\n    renderTask.isMainObjectRenderer = true;\n    fg.addTask(renderTask);\n\n    // Track the current output texture through the chain\n    let currentTexture : FrameGraphTextureHandle = renderTask.outputTexture;\n\n    // 3. SSAO (needs geometry renderer for depth/normals)\n    if(config.ssao)\n    {\n        const geoTask = new FrameGraphGeometryRendererTask('sage-geometry', fg, scene);\n        fg.addTask(geoTask);\n\n        const ssaoTask = new FrameGraphSSAO2RenderingPipelineTask('sage-ssao', fg, 0.5, 1.0);\n        ssaoTask.sourceTexture = currentTexture;\n        ssaoTask.depthTexture = geoTask.geometryViewDepthTexture;\n        ssaoTask.normalTexture = geoTask.geometryViewNormalTexture;\n        ssaoTask.camera = camera;\n        fg.addTask(ssaoTask);\n\n        if(config.ssao.radius !== undefined) { ssaoTask.ssao.radius = config.ssao.radius; }\n        if(config.ssao.samples !== undefined) { ssaoTask.ssao.samples = config.ssao.samples; }\n        if(config.ssao.totalStrength !== undefined) { ssaoTask.ssao.totalStrength = config.ssao.totalStrength; }\n\n        currentTexture = ssaoTask.outputTexture;\n    }\n\n    // 4. Bloom\n    if(config.bloom)\n    {\n        const bloomTask = new FrameGraphBloomTask(\n            'sage-bloom',\n            fg,\n            config.bloom.weight ?? 0.5,\n            config.bloom.kernel ?? 128,\n            config.bloom.threshold ?? 0.1,\n            true,\n            config.bloom.scale ?? 0.5\n        );\n        bloomTask.sourceTexture = currentTexture;\n        fg.addTask(bloomTask);\n\n        currentTexture = bloomTask.outputTexture;\n    }\n\n    // 5. Grain\n    if(config.grain)\n    {\n        const grainTask = new FrameGraphGrainTask('sage-grain', fg);\n        grainTask.sourceTexture = currentTexture;\n        fg.addTask(grainTask);\n\n        if(config.grain.intensity !== undefined) { grainTask.postProcess.intensity = config.grain.intensity; }\n        if(config.grain.animated !== undefined) { grainTask.postProcess.animated = config.grain.animated; }\n\n        currentTexture = grainTask.outputTexture;\n    }\n\n    // 6. Sharpen\n    if(config.sharpen)\n    {\n        const sharpenTask = new FrameGraphSharpenTask('sage-sharpen', fg);\n        sharpenTask.sourceTexture = currentTexture;\n        fg.addTask(sharpenTask);\n\n        if(config.sharpen.edge !== undefined) { sharpenTask.postProcess.edgeAmount = config.sharpen.edge; }\n        if(config.sharpen.color !== undefined) { sharpenTask.postProcess.colorAmount = config.sharpen.color; }\n\n        currentTexture = sharpenTask.outputTexture;\n    }\n\n    // 7. Chromatic aberration\n    if(config.chromaticAberration)\n    {\n        const chromTask = new FrameGraphChromaticAberrationTask('sage-chromab', fg);\n        chromTask.sourceTexture = currentTexture;\n        fg.addTask(chromTask);\n\n        if(config.chromaticAberration.amount !== undefined)\n        {\n            chromTask.postProcess.aberrationAmount = config.chromaticAberration.amount;\n        }\n\n        currentTexture = chromTask.outputTexture;\n    }\n\n    // 8. Image processing (tonemap + vignette)\n    if(config.tonemap || config.vignette)\n    {\n        const imgTask = new FrameGraphImageProcessingTask('sage-imgproc', fg);\n        imgTask.sourceTexture = currentTexture;\n        fg.addTask(imgTask);\n\n        if(config.tonemap)\n        {\n            imgTask.postProcess.toneMappingEnabled = true;\n\n            if(config.tonemap.operator)\n            {\n                imgTask.postProcess.toneMappingType\n                    = TONEMAP_OPERATORS[config.tonemap.operator]\n                    ?? ImageProcessingConfiguration.TONEMAPPING_STANDARD;\n            }\n        }\n\n        if(config.vignette)\n        {\n            imgTask.postProcess.vignetteEnabled = true;\n\n            if(config.vignette.weight !== undefined) { imgTask.postProcess.vignetteWeight = config.vignette.weight; }\n            if(config.vignette.stretch !== undefined)\n            {\n                imgTask.postProcess.vignetteStretch = config.vignette.stretch;\n            }\n            if(config.vignette.color)\n            {\n                const vc = config.vignette.color;\n                imgTask.postProcess.vignetteColor.set(vc.r, vc.g, vc.b, 1);\n            }\n        }\n\n        currentTexture = imgTask.outputTexture;\n    }\n\n    // 9. Volumetric lighting — not yet wired up for automatic light detection\n    if(config.volumetric)\n    {\n        console.warn(\n            '[SAGE] Volumetric lighting config is recognized but automatic light detection is not yet supported. '\n            + 'Use scene.frameGraph to add FrameGraphVolumetricLightingTask manually.'\n        );\n    }\n\n    // 10. Output to screen\n    const copyTask = new FrameGraphCopyToBackbufferColorTask('sage-output', fg);\n    copyTask.sourceTexture = currentTexture;\n    fg.addTask(copyTask);\n\n    // Wire up the scene — cameraToUseForPointers is needed because activeCamera becomes null between tasks\n    scene.cameraToUseForPointers = camera;\n    scene.frameGraph = fg;\n\n    // Rebuild on resize. The scene disposes the graph with itself, and the engine outlives both, so the\n    // observer goes with the scene rather than rebuilding a disposed graph for the engine's lifetime.\n    const resizeObserver = engine.onResizeObservable.add(async () =>\n    {\n        await fg.buildAsync();\n    });\n\n    scene.onDisposeObservable.addOnce(() =>\n    {\n        engine.onResizeObservable.remove(resizeObserver);\n    });\n\n    // Initial build\n    await fg.buildAsync();\n}\n\n//----------------------------------------------------------------------------------------------------------------------\n"],"mappings":"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"}

package/dist/sage.d.ts

@@ -1,30 +1,28 @@
 import { GameCanvas, SageOptions } from "./interfaces/game.d.ts";
 import { GameEngine } from "./classes/gameEngine.d.ts";
 import { GameEventBus } from "./classes/eventBus.d.ts";
+import { GameEntityType } from '@skewedaspect/sage-core';
 import { AudioEngine } from "./engines/audio.d.ts";
 import { SceneEngine } from "./engines/scene.d.ts";
 import { AssetManager } from "./managers/asset.d.ts";
-import { GameEntityDefinition } from "./interfaces/entity.d.ts";
 /**
- * Creates and initializes a fully-wired GameEngine with rendering, physics, input, and entity management.
+ * Creates and initializes a fully-wired GameEngine with rendering, physics, and entity management. The
+ * engine owns one InputManager (`engine.managers.inputManager`): its action registry, its action context
+ * registry, device state capture, and the routing loop that runs before each frame's fixed steps
+ * (docs/design/input.md). A game declares its own actions, contexts, and bindings onto it.
  *
  * @param canvas
- * @param entities - Entity definitions to register before the engine starts
+ * @param entityClasses - The entity class table, keyed by class name, that the simulation spawns from
  * @param options
  */
-export declare function createGameEngine(canvas: GameCanvas, entities: GameEntityDefinition[], options?: SageOptions): Promise<GameEngine>;
-export * from "./interfaces/action.d.ts";
-export * from "./interfaces/binding.d.ts";
-export * from "./interfaces/entity.d.ts";
+export declare function createGameEngine(canvas: GameCanvas, entityClasses: Readonly<Record<string, GameEntityType>>, options?: SageOptions): Promise<GameEngine>;
 export * from "./interfaces/game.d.ts";
-export * from "./interfaces/input.d.ts";
 export * from "./interfaces/logger.d.ts";
 export { AssetManager, AudioEngine, GameEngine, GameEventBus, SceneEngine };
+export type { SimulationFactory } from "./classes/gameEngine.d.ts";
 export * from "./classes/eventBus.d.ts";
-export * from "./classes/entity.d.ts";
 export * from "./classes/level.d.ts";
 export * from "./classes/gameLevel.d.ts";
-export * from "./behaviors/index.d.ts";
 export * from "./events/index.d.ts";
 export * from "./handlers/index.d.ts";
 export * from "./interfaces/level.d.ts";
@@ -33,20 +31,60 @@ export * from "./utils/logger.d.ts";
 export * from "./utils/metadata.d.ts";
 export * from "./utils/timer.d.ts";
 export * from "./utils/version.d.ts";
+export { Behavior, EventBus, GameEntity, GameSimulationManager, NamedBehavior, StateMachineBehavior, defineStates, dilationLimit, drainPassLimit, operationCallDepthLimit, } from '@skewedaspect/sage-core';
+export type { BehaviorClass, ComposedOf, DeepReadonly, EventMap, EventSubscription, GameEntityState, GameEntityType, GameEvent as GameEntityEvent, GameSimulationContext, GameSimulationOptions, GameSimulationSnapshot, NamedState, NarrowedTo, OpsFor, OpsOf, StateBag, StateFor, StateSliceOf, } from '@skewedaspect/sage-core';
+export { NodeEntity } from "./entities/nodeEntity.d.ts";
+export type { NodeEntityState, QuaternionState, Vector3State } from "./entities/nodeEntity.d.ts";
+export { NodePool } from "./entities/nodePool.d.ts";
+export { NodeSimulation } from "./entities/nodeSimulation.d.ts";
+export type { NodeSimulationOptions } from "./entities/nodeSimulation.d.ts";
+export type { MeshLoader, NodeSet, NodeSimulationContext } from "./entities/nodeSimulationContext.d.ts";
+export type { EntityPickFilter, EntityPickResult } from "./entities/entityPicking.d.ts";
+export { defineEntity } from "./entities/defineEntity.d.ts";
+export type { GameEntityDefinition, GameEntityDefinitionClass } from "./entities/defineEntity.d.ts";
+export { buildStandardMeshSource } from "./entities/standardMeshSource.d.ts";
+export type { MeshAssetSource } from "./entities/standardMeshSource.d.ts";
+export type { MeshConfig, MeshMaterialConfig } from "./entities/meshConfig.d.ts";
+export { SoundBehavior } from "./behaviors/sound.d.ts";
+export type { SoundConfig, SoundState } from "./behaviors/sound.d.ts";
+export { ActionRegistry } from "./input/actionRegistry.d.ts";
+export { ActionContextRegistry } from "./input/actionContext.d.ts";
+export type { Binding, BindingDefinition, BindingFire, BindingInput, BindingKind, DeviceID, DeviceType, } from "./input/binding.d.ts";
+export type { DeviceReader } from "./input/deviceReader.d.ts";
+export type { GamepadState, KeyboardState, MouseState } from "./input/deviceState.d.ts";
+export { KeyboardReader } from "./input/deviceReaders/keyboard.d.ts";
+export { MouseReader } from "./input/deviceReaders/mouse.d.ts";
+export type { MouseSourceType } from "./input/deviceReaders/mouse.d.ts";
+export { GamepadReader } from "./input/deviceReaders/gamepad.d.ts";
+export type { GamepadSourceType } from "./input/deviceReaders/gamepad.d.ts";
+export { TriggerBinding } from "./input/bindings/trigger.d.ts";
+export type { EdgeMode, TriggerOptions } from "./input/bindings/trigger.d.ts";
+export { ToggleBinding } from "./input/bindings/toggle.d.ts";
+export type { ToggleOptions } from "./input/bindings/toggle.d.ts";
+export { ValueBinding } from "./input/bindings/value.d.ts";
+export type { ValueOptions } from "./input/bindings/value.d.ts";
+export { DeltaBinding } from "./input/bindings/delta.d.ts";
+export type { DeltaOptions } from "./input/bindings/delta.d.ts";
+export { resolveBinding } from "./input/resolveBinding.d.ts";
+export { deliverAction } from "./input/deliverAction.d.ts";
+export { InputCapture } from "./input/inputCapture.d.ts";
+export type { CandidateInput, CaptureOptions } from "./input/inputCapture.d.ts";
+export { exportConfiguration, importConfiguration } from "./input/configuration.d.ts";
+export type { Configuration, ContextDefinition } from "./input/configuration.d.ts";
+export type { Action, AnalogAction, DigitalAction } from '@skewedaspect/sage-core';
 export type { FrameCallback } from "./managers/game.d.ts";
-export type { CreateEntityOptions } from "./managers/entity.d.ts";
+export { InputManager, ROUTING_LOOP_SENDER_ID } from "./managers/input.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 { SimulationSaveManager } from "./managers/simulationSave.d.ts";
+export type { BeforeSaveHook, LevelLoader, LoadResult, SaveEnvelope } from "./managers/simulationSave.d.ts";
 export { DebugConsole } from "./classes/debugConsole.d.ts";
-export { createEntityProxy } from "./utils/entityProxy.d.ts";
+export { computeHierarchyBounds } from "./utils/bounds.d.ts";
+export type { HierarchyBounds } from "./utils/bounds.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 { getCanonicalTransform, toQuatObject, toQuaternion, toVec3Object, toVector3, } from "./utils/vectors.d.ts";