@skewedaspect/sage 0.9.6 → 0.10.0-beta.1

package/dist/input/deliverAction.d.ts

@@ -0,0 +1,3 @@
+import { GameSimulationContext } from '@skewedaspect/sage-core';
+import { Binding } from "./binding.d.ts";
+export declare function deliverAction<State>(binding: Binding<State>, state: State, context: GameSimulationContext, senderID: string, targetID: string): void;

package/dist/input/deviceReader.d.ts

@@ -0,0 +1,5 @@
+export interface DeviceReader<State> {
+    readonly sourceType: string;
+    readonly sourceKey: string;
+    getValue(state: State): boolean | number | undefined;
+}

package/dist/input/deviceReaders/gamepad.d.ts

@@ -0,0 +1,9 @@
+import { GamepadState } from "../deviceState.d.ts";
+import { DeviceReader } from "../deviceReader.d.ts";
+export type GamepadSourceType = 'button' | 'axis';
+export declare class GamepadReader implements DeviceReader<GamepadState> {
+    readonly sourceType: GamepadSourceType;
+    readonly sourceKey: string;
+    constructor(sourceType: GamepadSourceType, sourceKey: string);
+    getValue(state: GamepadState): boolean | number | undefined;
+}

package/dist/input/deviceReaders/keyboard.d.ts

@@ -0,0 +1,8 @@
+import { KeyboardState } from "../deviceState.d.ts";
+import { DeviceReader } from "../deviceReader.d.ts";
+export declare class KeyboardReader implements DeviceReader<KeyboardState> {
+    readonly sourceType = "key";
+    readonly sourceKey: string;
+    constructor(sourceKey: string);
+    getValue(state: KeyboardState): boolean | undefined;
+}

package/dist/input/deviceReaders/mouse.d.ts

@@ -0,0 +1,9 @@
+import { MouseState } from "../deviceState.d.ts";
+import { DeviceReader } from "../deviceReader.d.ts";
+export type MouseSourceType = 'button' | 'position' | 'wheel';
+export declare class MouseReader implements DeviceReader<MouseState> {
+    readonly sourceType: MouseSourceType;
+    readonly sourceKey: string;
+    constructor(sourceType: MouseSourceType, sourceKey: string);
+    getValue(state: MouseState): boolean | number | undefined;
+}

package/dist/input/deviceState.d.ts

@@ -0,0 +1,19 @@
+export interface KeyboardState {
+    readonly keys: Readonly<Record<string, boolean>>;
+}
+export interface MouseState {
+    readonly buttons: Readonly<Record<string, boolean>>;
+    readonly position: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly wheel: Readonly<{
+        deltaX: number;
+        deltaY: number;
+        deltaZ: number;
+    }>;
+}
+export interface GamepadState {
+    readonly buttons: Readonly<Record<string, number>>;
+    readonly axes: Readonly<Record<string, number>>;
+}

package/dist/input/inputCapture.d.ts

@@ -0,0 +1,21 @@
+import { BindingInput, DeviceType } from "./binding.d.ts";
+export interface CaptureOptions {
+    deviceTypes?: readonly DeviceType[];
+    sourceTypes?: readonly string[];
+    signal?: AbortSignal;
+}
+export interface CandidateInput {
+    device: {
+        type: DeviceType;
+        index: number;
+    };
+    sourceType: string;
+    sourceKey: string;
+    value: boolean | number;
+}
+export declare class InputCapture {
+    #private;
+    constructor(options?: CaptureOptions);
+    feed(candidate: CandidateInput): void;
+    wait(): Promise<BindingInput>;
+}

package/dist/input/resolveBinding.d.ts

@@ -0,0 +1,4 @@
+import { Action } from '@skewedaspect/sage-core';
+import { Binding, BindingDefinition } from "./binding.d.ts";
+import { DeviceReader } from "./deviceReader.d.ts";
+export declare function resolveBinding<State>(definition: BindingDefinition, action: Action, reader: DeviceReader<State>): Binding<State>;

package/dist/interfaces/game.d.ts

@@ -1,6 +1,14 @@
-import { EngineOptions, NullEngineOptions, WebGPUEngineOptions } from '@babylonjs/core';
+import { AbstractMesh, EngineOptions, NullEngineOptions, Scene, WebGPUEngineOptions } from '@babylonjs/core';
+import { StateBag } from '@skewedaspect/sage-core';
 import { LogLevel } from "./logger.d.ts";
-import { BindingDefinition } from "./binding.d.ts";
+/**
+ * Builds a NodeEntity class's mesh from its name and state, into the given scene.
+ *
+ * NodeSimulationContext's own MeshLoader carries no scene, because the same context that calls it also holds
+ * the scene -- but a game's own loader is authored once, before any scene exists, and reused across every
+ * level's simulation, so it needs the scene handed in.
+ */
+export type EntityMeshLoader = (scene: Scene, name: string, state: Readonly<StateBag>) => Promise<AbstractMesh | undefined>;
 export type GameCanvas = HTMLCanvasElement | OffscreenCanvas | null;
 /** Specifies which rendering engine to force using */
 export type EngineType = 'webgl' | 'webgpu' | 'auto';
@@ -19,8 +27,6 @@ export type RenderEngineOptions = (BabylonEngineOptions | NullEngineOptions | We
 export interface SageOptions {
     /** Render engine options for BabylonJS */
     renderOptions?: RenderEngineOptions;
-    /** Input bindings to be registered at startup */
-    bindings?: BindingDefinition[];
     /** Logging level for the engine */
     logLevel?: LogLevel;
     /** Audio channel names. If provided, SAGE initializes AudioV2 with one bus per channel. */
@@ -40,4 +46,14 @@ export interface SageOptions {
     debug?: false | {
         namespace?: string;
     };
+    /**
+     * Pre-loaded Havok WASM binary, for booting outside a browser.
+     *
+     * Havok normally fetches its own WASM over HTTP; in node there is nothing to fetch from, so the
+     * bytes have to be handed in. Browsers should leave this unset -- it is not a performance knob,
+     * and setting it does not change how physics behaves.
+     */
+    havokBinary?: BufferSource;
+    /** The simulation's fixed step duration, in seconds. Default 1/60. */
+    fixedStepDuration?: number;
 }

package/dist/interfaces/level.d.ts

@@ -1,7 +1,18 @@
 import { Scene, TransformNode } from '@babylonjs/core';
 import { GameEngine } from "../classes/gameEngine.d.ts";
+import { EntityMeshLoader } from "./game.d.ts";
 import { ColliderDebugConfig } from "../managers/colliderDebug.d.ts";
 import { LoggingUtility } from "../utils/logger.d.ts";
+/**
+ * Options controlling how a level loads.
+ */
+export interface LevelLoadOptions {
+    /**
+     * If true, this load is restoring a save: the level runs no marker-driven spawning of its own, since the
+     * restored snapshot is the sole source of entities (design/simulation.md#saved-games).
+     */
+    forRestore?: boolean;
+}
 /**
  * Minimal interface for Level that property handlers receive.
  * This avoids circular dependencies while still providing access to level functionality.
@@ -51,7 +62,9 @@ export interface SpawnDefinition {
  * Used to configure entities that are marked with the 'entity' property in scene files.
  */
 export interface EntityDefinition {
-    /** Optional name override for the entity (overrides the scene node name). */
+    /** The entity type name to spawn, adopting the marked node. */
+    entity: string;
+    /** Optional human-readable name for the entity instance. */
     name?: string;
     /** Tags to apply to the entity (merged with definition tags). */
     tags?: string[];
@@ -81,6 +94,11 @@ export interface SceneConfig {
 export interface LevelConfig {
     /** The name of the level */
     name: string;
+    /**
+     * Builds a NodeEntity class's mesh from its name and state, into the level's scene. Left unset, every
+     * entity this level spawns gets a node with no mesh.
+     */
+    meshSource?: EntityMeshLoader;
     /** Scene file path, or configuration object with path and options */
     scene?: string | SceneConfig;
     /** Name of a registered custom Level class to use instead of GameLevel */

package/dist/managers/game.d.ts

@@ -1,9 +1,8 @@
 import { AbstractEngine, Scene } from '@babylonjs/core';
 import { Disposable } from "../interfaces/lifecycle.d.ts";
 import { GameEventBus } from "../classes/eventBus.d.ts";
-import { GameEntityManager } from "./entity.d.ts";
+import { GameEngine } from "../classes/gameEngine.d.ts";
 import { LevelManager } from "./level.d.ts";
-import { UserInputManager } from "./input.d.ts";
 import { LoggingUtility } from "../utils/logger.d.ts";
 /**
  * Callback function for frame updates.
@@ -13,8 +12,7 @@ export type FrameCallback = (deltaTime: number) => void;
 export declare class GameManager implements Disposable {
     private _engine;
     private _eventBus;
-    private _entityManager;
-    private _inputManager;
+    private _gameEngine;
     private _levelManager;
     private _log;
     private _boundRenderLoop;
@@ -26,8 +24,13 @@ export declare class GameManager implements Disposable {
     /** Whether the game is currently paused */
     private _paused;
     started: boolean;
-    constructor(engine: AbstractEngine, eventBus: GameEventBus, entityManager: GameEntityManager, inputManager: UserInputManager, levelManager: LevelManager, logger?: LoggingUtility);
+    constructor(engine: AbstractEngine, eventBus: GameEventBus, levelManager: LevelManager, logger?: LoggingUtility);
     get currentScene(): Scene | null;
+    /**
+     * Late-bind the GameEngine after construction.
+     * Called by createGameEngine() after the GameEngine instance is created.
+     */
+    $setGameEngine(gameEngine: GameEngine): void;
     /**
      * Whether the game is currently paused.
      * When paused, entity updates and frame callbacks are skipped, but rendering continues.

package/dist/managers/level.d.ts

@@ -1,4 +1,4 @@
-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";
@@ -7,7 +7,7 @@ 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 +137,16 @@ 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): Promise<Level>;
+    loadLevel(config: LevelConfig, options?: LevelLoadOptions): Promise<Level>;
     /**
      * 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,30 @@
+import { GameSimulationManager, GameSimulationSnapshot } from '@skewedaspect/sage-core';
+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>;
+}
+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: GameSimulationManager;
+    envelope: SaveEnvelope;
+}
+export declare class SimulationSaveManager implements Disposable {
+    #private;
+    constructor(levelLoader: LevelLoader, engineVersion: string, now?: () => number);
+    onBeforeSave(hook: BeforeSaveHook): void;
+    save(simulation: GameSimulationManager): SaveEnvelope;
+    load(envelope: SaveEnvelope, simulation: GameSimulationManager): Promise<LoadResult>;
+    $teardown(): Promise<void>;
+}

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

@@ -67,4 +67,4 @@ async function m(m, h) {
 //#endregion
 export { m as applyFrameGraphPostProcessing };
 
-//# sourceMappingURL=postProcessingFrameGraph-CaMgQzR-.js.map
+//# sourceMappingURL=postProcessingFrameGraph-rr2DbgPi.js.map

package/dist/{postProcessingFrameGraph-CaMgQzR-.js.map → postProcessingFrameGraph-rr2DbgPi.js.map}

@@ -1 +1 @@
-{"version":3,"file":"postProcessingFrameGraph-CaMgQzR-.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    // Create the main render target texture\n    const colorTexture = fg.textureManager.createRenderTargetTexture('sage-fg-color', {\n        size: { width: 100, height: 100 },\n        sizeIsPercentage: true,\n        options: { formats: [ Constants.TEXTUREFORMAT_RGBA ], samples: 4 },\n    });\n\n    // 1. Clear\n    const clearTask = new FrameGraphClearTextureTask('sage-clear', fg);\n    clearTask.targetTexture = colorTexture;\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\n    engine.onResizeObservable.add(async () =>\n    {\n        await fg.buildAsync();\n    });\n\n    // Initial build\n    await fg.buildAsync();\n}\n\n//----------------------------------------------------------------------------------------------------------------------\n"],"mappings":"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"}
+{"version":3,"file":"postProcessingFrameGraph-rr2DbgPi.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    // Create the main render target texture\n    const colorTexture = fg.textureManager.createRenderTargetTexture('sage-fg-color', {\n        size: { width: 100, height: 100 },\n        sizeIsPercentage: true,\n        options: { formats: [ Constants.TEXTUREFORMAT_RGBA ], samples: 4 },\n    });\n\n    // 1. Clear\n    const clearTask = new FrameGraphClearTextureTask('sage-clear', fg);\n    clearTask.targetTexture = colorTexture;\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\n    engine.onResizeObservable.add(async () =>\n    {\n        await fg.buildAsync();\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,27 @@
 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. A
+ * game builds its own action registry, contexts, and bindings from the exported input module -- the engine
+ * supplies the pieces input.md and events.md#delivery describe, not a device-to-binding routing loop.
  *
  * @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 +30,53 @@ 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, GameEntity, GameSimulationManager } from '@skewedaspect/sage-core';
+export type { BehaviorClass, ComposedOf, EventMap, EventSubscription, GameEntityState, GameEntityType, GameEvent as GameEntityEvent, GameSimulationContext, GameSimulationOptions, GameSimulationSnapshot, NarrowedTo, OpsFor, StateBag, StateFor, } 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 { 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 { 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 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 { 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";