@skewedaspect/sage 0.9.6 → 0.10.0-beta.2

package/dist/managers/binding.d.ts

@@ -1,233 +0,0 @@
-import { GameEventBus } from "../classes/eventBus.d.ts";
-import { Binding, BindingDefinition, CaptureInputOptions, Context, InputDefinition } from "../interfaces/binding.d.ts";
-import { Disposable } from "../interfaces/lifecycle.d.ts";
-import { DeviceType, InputDevice, InputState } from "../interfaces/input.d.ts";
-import { Action } from "../interfaces/action.d.ts";
-import { LoggingUtility } from "../utils/logger.d.ts";
-/**
- * Configuration object structure for binding manager
- */
-export interface BindingConfiguration {
-    /** All registered actions */
-    actions: Action[];
-    /** All registered bindings */
-    bindings: BindingDefinition[];
-    /** All registered contexts */
-    contexts: {
-        name: string;
-        exclusive: boolean;
-        active: boolean;
-    }[];
-}
-/**
- * Manages input bindings and actions for the game
- */
-export declare class BindingManager implements Disposable {
-    /** Map of device IDs to their bindings */
-    private _bindings;
-    /** Map of action names to their action definitions */
-    private _actions;
-    /** Map of all registered contexts by name for O(1) lookup */
-    private _contexts;
-    /**
-     * Set of all active contexts (both exclusive and non-exclusive)
-     */
-    private _activeContexts;
-    /** The most recent device type that produced intentional input */
-    private _lastActiveDeviceType;
-    /** Last input state per device, used to prime edge state on context activation */
-    private _lastInputState;
-    /** Active captureInput() state, or null when not capturing */
-    private _captureState;
-    /** Event bus for handling game events */
-    private _eventBus;
-    /** Unsubscribe function for input events */
-    private _inputUnsubscribe;
-    /** Logger instance */
-    private _log;
-    /**
-     * Creates an instance of BindingManager.
-     * Automatically subscribes to 'input:changed' events on the event bus.
-     *
-     * @param eventBus
-     * @param logger
-     */
-    constructor(eventBus: GameEventBus, logger?: LoggingUtility);
-    /**
-     * Checks if a binding's context is currently active.
-     * Bindings with no context are always considered active.
-     *
-     * @param binding
-     */
-    private _isBindingContextActive;
-    /**
-     * Get a context by name, creating it if it doesn't exist.
-     *
-     * @param contextName
-     * @param exclusive - Only used when creating a new context
-     */
-    private _getOrCreateContext;
-    /**
-     * Deactivate all exclusive contexts except the specified one.
-     * Non-exclusive contexts are left untouched.
-     *
-     * @param exceptContextName
-     */
-    private _deactivateExclusiveContexts;
-    /**
-     * Determines whether an input event represents intentional activity that should
-     * update the last-active device type. Filters out noise like idle mousemove.
-     *
-     * @param state
-     */
-    private _shouldUpdateActiveDevice;
-    /**
-     * Create a binding from a binding definition.
-     *
-     * @param definition
-     * @returns Null if the action is not registered or the binding type is unsupported
-     */
-    private _createBindingFromDefinition;
-    /**
-     * Create a device value reader from a definition object.
-     *
-     * @param definition
-     * @throws Error if the reader type is not supported
-     */
-    private _createInputSourceFromDefinition;
-    /**
-     * Evaluates an input event during capture mode. If the event matches the capture criteria,
-     * resolves the capture promise and cleans up. Otherwise does nothing and waits for the next event.
-     *
-     * @param device
-     * @param state
-     */
-    private _processCaptureInput;
-    /**
-     * Tears down capture state, deactivates the temporary context, and restores the
-     * snapshotted contexts. Does not resolve or reject — the caller handles that.
-     */
-    private _cleanupCapture;
-    /**
-     * Handle input from a device and process all relevant bindings.
-     *
-     * **Internal API**: This method is prefixed with `$` to indicate it is intended for internal
-     * engine use only. While it is public for testing purposes, external code should not call
-     * this method directly. Input handling is triggered automatically via the event bus.
-     *
-     * @param device - The input device
-     * @param state - Current input state
-     *
-     * @internal
-     */
-    $handleInput(device: InputDevice, state: InputState): void;
-    /**
-     * Registers an action.
-     *
-     * @param action
-     * @throws Error if action is already registered
-     */
-    registerAction(action: Action): void;
-    /**
-     * Gets an action by name.
-     *
-     * @param actionName
-     */
-    getAction(actionName: string): Action | null;
-    /**
-     * Returns the device type that most recently produced intentional input,
-     * or `null` if no input has been received yet.
-     */
-    get lastActiveDeviceType(): DeviceType | null;
-    /**
-     * Waits for the next intentional input event and returns a descriptor suitable for constructing
-     * a binding. While capturing, all normal bindings are suppressed via a temporary exclusive context.
-     * Previous context state is restored when the capture completes or is cancelled.
-     *
-     * @param options
-     * @throws Error if a capture is already in progress
-     */
-    captureInput(options: CaptureInputOptions): Promise<InputDefinition>;
-    /**
-     * Registers a context with specific options.
-     * Updates exclusivity if the context already exists.
-     *
-     * @param contextName
-     * @param exclusive
-     */
-    registerContext(contextName: string, exclusive?: boolean): Context;
-    /**
-     * Activates a context, enabling all bindings associated with it.
-     * If the context is exclusive, all other exclusive contexts will be deactivated.
-     *
-     * @param contextName
-     */
-    activateContext(contextName: string): void;
-    /**
-     * Deactivates a context, disabling all bindings associated with it.
-     *
-     * @param contextName
-     */
-    deactivateContext(contextName: string): void;
-    /**
-     * Returns a list of all active contexts.
-     */
-    getActiveContexts(): string[];
-    /**
-     * Returns whether a context is active.
-     *
-     * @param contextName
-     */
-    isContextActive(contextName: string): boolean;
-    /**
-     * Gets a context by name.
-     *
-     * @param contextName
-     */
-    getContext(contextName: string): Context | null;
-    /**
-     * Register a binding for an input device.
-     * Auto-registers the binding's context if not already known.
-     *
-     * @param binding
-     * @throws Error if binding type is invalid
-     */
-    $registerBinding(binding: Binding): void;
-    /**
-     * Register a binding using a binding definition object.
-     * Creates the appropriate Binding subclass and registers it.
-     *
-     * @param definition
-     */
-    registerBinding(definition: BindingDefinition): void;
-    /**
-     * Unregister all bindings for an action within a context.
-     *
-     * @param actionName
-     * @param context - Pass null (default) to target context-free bindings
-     */
-    unregisterBindings(actionName: string, context?: string | null): void;
-    /**
-     * Gets all bindings for a specific action, optionally filtered by device type and/or context.
-     *
-     * @param actionName
-     * @param deviceType - If provided, filters to only bindings for that device type
-     * @param context - If provided, filters to only bindings in that context
-     */
-    getBindingsForAction(actionName: string, deviceType?: DeviceType, context?: string | null): Binding[];
-    /**
-     * Exports the current configuration to a serializable object.
-     * Includes all actions, bindings, contexts, and their active states.
-     */
-    exportConfiguration(): BindingConfiguration;
-    /**
-     * Imports a configuration, replacing all current actions, bindings, and contexts.
-     *
-     * @param config
-     */
-    importConfiguration(config: BindingConfiguration): void;
-    /**
-     * Tears down the binding manager and cleans up any resources
-     */
-    $teardown(): Promise<void>;
-}

package/dist/managers/entity.d.ts

@@ -1,264 +0,0 @@
-import { TransformNode } from '@babylonjs/core';
-import { GameEntity, RequestResult } from "../classes/entity.d.ts";
-import { GameEventBus } from "../classes/eventBus.d.ts";
-import { GameEngine } from "../classes/gameEngine.d.ts";
-import { GameEntityDefinition } from "../interfaces/entity.d.ts";
-import { Disposable } from "../interfaces/lifecycle.d.ts";
-import { BindingManager } from "../managers/binding.d.ts";
-import { LoggingUtility } from "../utils/logger.d.ts";
-/**
- * Options for creating an entity instance.
- */
-export interface CreateEntityOptions<State extends object = object> {
-    /** Initial state to merge with defaultState. */
-    initialState?: Partial<State>;
-    /** Override name from entity definition. */
-    name?: string;
-    /** Additional tags to add (merged with definition tags). */
-    tags?: string[];
-    /** Scene node to attach the entity to. */
-    node?: TransformNode;
-    /**
-     * Build the definition's mesh via the current level ('disabled' loads it setEnabled(false)).
-     * Mutually exclusive with `node`.
-     */
-    mesh?: 'enabled' | 'disabled';
-}
-export declare class GameEntityManager implements Disposable {
-    /** The event bus for the entity manager. */
-    private eventBus;
-    /** A map of entities managed by the entity manager. */
-    private entities;
-    /** A map of entity definitions registered with the entity manager. */
-    private entityDefinitions;
-    /** Late-bound GameEngine reference */
-    private _gameEngine;
-    /** Reference to the binding manager for registering actions */
-    private bindingManager;
-    /** Logger instance */
-    private _log;
-    /** Index: name -> entity (names are not unique, first match returned by getByName) */
-    private _entitiesByName;
-    /** Index: type -> entities */
-    private _entitiesByType;
-    /** Index: tag -> entities */
-    private _entitiesByTag;
-    /** Index: node -> entity (one entity per node) */
-    private _entitiesByNode;
-    /** Object pool storage: type -> pooled entities */
-    private _pools;
-    /**
-     * Creates an instance of EntityManager.
-     * @param eventBus
-     * @param logger
-     * @param bindingManager
-     */
-    constructor(eventBus: GameEventBus, logger: LoggingUtility | undefined, bindingManager: BindingManager);
-    /**
-     * Late-bind the GameEngine after construction.
-     * Called by createGameEngine() after the GameEngine instance is created.
-     */
-    $setGameEngine(gameEngine: GameEngine): void;
-    private get _engine();
-    /**
-     * Gets or creates a Set in a Map, returning the Set.
-     */
-    private _getOrCreateSet;
-    /**
-     * Adds an entity to all relevant indices.
-     */
-    private _indexEntity;
-    /**
-     * Removes an entity from all indices.
-     */
-    private _unindexEntity;
-    /**
-     * Resolves an entity definition that extends a base definition by merging according to inheritance rules.
-     * The base definition must already be registered.
-     */
-    private _resolveInheritance;
-    /**
-     * Checks if two actions are compatible (same type and non-conflicting options).
-     * @param existingAction - The action already registered
-     * @param newAction - The action being registered
-     */
-    private _areActionsCompatible;
-    /**
-     * Registers actions defined in the entity definition with the binding manager.
-     * Skips actions already registered with compatible options; warns on conflicts.
-     * @param entityDef
-     */
-    private _registerEntityActions;
-    $frameUpdate(dt: number): void;
-    /**
-     * Deep-clone a definition's defaultState for a new instance.
-     *
-     * A shallow spread would hand every instance of a type the same nested arrays and objects — mutate one
-     * entity's inventory slots and you mutate its neighbor's. Definitions must keep defaultState as plain,
-     * structured-cloneable data.
-     */
-    private _cloneDefaultState;
-    /**
-     * Honor the `mesh` create option by building the definition's mesh on the current level.
-     */
-    private _buildDefinitionMesh;
-    /**
-     * Registers a new entity definition.
-     * Also registers any actions declared in the definition with the binding manager.
-     * @param entityDef
-     */
-    registerEntityDefinition(entityDef: GameEntityDefinition): void;
-    /**
-     * Retrieve an entity definition by type.
-     * @param type
-     */
-    getDefinition(type: string): GameEntityDefinition | undefined;
-    /**
-     * Creates a new entity of the given type.
-     * Runs onBeforeCreate/onCreate lifecycle hooks, merges state, applies tags, and indexes the entity.
-     * @param type - Must match a previously registered entity definition
-     * @param options
-     */
-    createEntity<State extends object = object>(type: string, options?: CreateEntityOptions<State>): Promise<GameEntity<State>>;
-    /**
-     * Destroys the entity with the given ID.
-     * Runs onBeforeDestroy/onDestroy lifecycle hooks, unindexes, and removes the entity.
-     * @param entityID
-     */
-    destroyEntity(entityID: string): Promise<void>;
-    /**
-     * Gets the entity with the given ID.
-     * @param entityID
-     */
-    getEntity(entityID: string): GameEntity | null;
-    /**
-     * Adds an existing entity to the entity manager and indexes it.
-     * @param entity
-     */
-    addEntity(entity: GameEntity): void;
-    /**
-     * Removes the entity with the given ID, without destroying it.
-     * @param entityID
-     */
-    removeEntity(entityID: string): void;
-    /**
-     * Adds a child entity to a parent entity.
-     * @param parentId - ID of the parent entity
-     * @param childId - ID of the child entity
-     * @returns False if either entity is not found
-     */
-    addChild(parentId: string, childId: string): boolean;
-    /**
-     * Removes a child entity from a parent entity.
-     * @param parentId - ID of the parent entity
-     * @param childId - ID of the child entity
-     * @returns False if either entity is not found
-     */
-    removeChild(parentId: string, childId: string): boolean;
-    /**
-     * Gets the first entity with the given name.
-     * Names are not unique; use getEntitiesByName() to retrieve all matches.
-     * @param name
-     */
-    getByName(name: string): GameEntity | undefined;
-    /**
-     * Gets all entities with the given name.
-     * @param name
-     */
-    getEntitiesByName(name: string): GameEntity[];
-    /**
-     * Gets all entities of the given type.
-     * @param type
-     */
-    getByType(type: string): GameEntity[];
-    /**
-     * Gets all entities with the given tag.
-     * @param tag
-     */
-    getByTag(tag: string): GameEntity[];
-    /**
-     * Gets all entities matching multiple tags.
-     * @param tags
-     * @param mode - 'all' requires every tag (intersection), 'any' requires at least one (union)
-     */
-    getByTags(tags: string[], mode?: 'all' | 'any'): GameEntity[];
-    /**
-     * Returns an iterator over all entities.
-     * More memory-efficient than returning an array for large entity counts.
-     */
-    getAllEntities(): IterableIterator<GameEntity>;
-    /**
-     * Gets the total number of entities.
-     */
-    get entityCount(): number;
-    /**
-     * Sends a fire-and-forget event directly to a specific entity's behaviors, bypassing the event bus.
-     * Resolves the target by entity ID first (O(1)), then falls back to name lookup (O(1)).
-     *
-     * @param target - Entity ID or name
-     * @param type - Event type string
-     * @param payload - Optional event payload
-     */
-    send(target: string, type: string, payload?: unknown, senderID?: string): Promise<void>;
-    /**
-     * Sends a request to a specific entity's behaviors and returns the first response.
-     * Resolves the target by entity ID first (O(1)), then falls back to name lookup (O(1)).
-     *
-     * @param target - Entity ID or name
-     * @param type - Request type string
-     * @param payload - Optional request payload
-     * @param senderID - Optional sender entity ID (stamped on the event)
-     */
-    request<T>(target: string, type: string, payload?: unknown, senderID?: string): Promise<RequestResult<T>>;
-    /**
-     * Adds a tag to an entity and updates the tag index.
-     * @param entity - Entity instance or entity ID
-     * @param tag
-     * @returns False if already present or entity not found
-     */
-    addTag(entity: GameEntity | string, tag: string): boolean;
-    /**
-     * Removes a tag from an entity and updates the tag index.
-     * @param entity - Entity instance or entity ID
-     * @param tag
-     * @returns False if not present or entity not found
-     */
-    removeTag(entity: GameEntity | string, tag: string): boolean;
-    /**
-     * Gets an entity by its attached scene node.
-     * @param node
-     */
-    getByNode(node: TransformNode): GameEntity | undefined;
-    /**
-     * Attaches an entity to a scene node.
-     * The entity will reference this node and can be looked up via getByNode().
-     *
-     * @param entity - Entity instance or entity ID
-     * @param node
-     * @returns False if entity not found or node already has an entity
-     */
-    attachToNode(entity: GameEntity | string, node: TransformNode): boolean;
-    /**
-     * Detaches an entity from its scene node.
-     *
-     * @param entity - Entity instance or entity ID
-     * @returns False if entity not found or had no node
-     */
-    detachFromNode(entity: GameEntity | string): boolean;
-    /**
-     * Pre-creates entities and pools them for fast recycling.
-     * @param type - Entity type to prewarm
-     * @param count - Number of entities to create and pool
-     */
-    prewarm(type: string, count: number): Promise<void>;
-    /**
-     * Drains the pool for a given type, actually destroying all pooled entities.
-     * @param type - Entity type whose pool to drain
-     */
-    drainPool(type: string): Promise<void>;
-    /**
-     * Tears down all entities and releases resources.
-     * Destroys entities individually (running lifecycle hooks), then clears definitions and indices.
-     */
-    $teardown(): Promise<void>;
-}

package/dist/managers/save.d.ts

@@ -1,75 +0,0 @@
-import { Disposable } from "../interfaces/lifecycle.d.ts";
-import { GameEntityManager } from "./entity.d.ts";
-import { LevelManager } from "./level.d.ts";
-import { LoggingUtility } from "../utils/logger.d.ts";
-export interface SaveData {
-    version: number;
-    levelName: string;
-    entities: SerializedEntity[];
-    custom: Record<string, unknown>;
-}
-export interface SerializedEntity {
-    id: string;
-    type: string;
-    name?: string;
-    tags: string[];
-    state: object;
-    parentId?: string;
-    transform?: {
-        position: {
-            x: number;
-            y: number;
-            z: number;
-        };
-        rotation: {
-            x: number;
-            y: number;
-            z: number;
-        };
-        scaling: {
-            x: number;
-            y: number;
-            z: number;
-        };
-    };
-}
-type BeforeSerializeHook = () => Record<string, unknown>;
-type AfterDeserializeHook = (custom: Record<string, unknown>) => void;
-export declare class SaveManager implements Disposable {
-    private _entityManager;
-    private _levelManager;
-    private _log;
-    private _beforeSerializeHooks;
-    private _afterDeserializeHooks;
-    constructor(entityManager: GameEntityManager, levelManager: LevelManager, logger?: LoggingUtility);
-    /**
-     * Register a hook that returns custom data to include in save data.
-     * Multiple hooks can be registered; their results are merged into the `custom` field.
-     */
-    onBeforeSerialize(hook: BeforeSerializeHook): void;
-    /**
-     * Register a hook to process custom data when loading a save.
-     * Multiple hooks can be registered; each receives the full custom data object.
-     */
-    onAfterDeserialize(hook: AfterDeserializeHook): void;
-    /**
-     * Captures the current game state as a serializable SaveData object.
-     * Iterates all entities, captures transforms, state, tags, and parent references.
-     * Calls all beforeSerialize hooks to gather custom data.
-     */
-    serialize(): SaveData;
-    /**
-     * Restores game state from a SaveData object.
-     *
-     * Flow:
-     * 1. Transition to the saved level
-     * 2. Destroy all existing entities (level-spawned ones)
-     * 3. Recreate entities from save data
-     * 4. Restore transforms on entities with nodes
-     * 5. Re-establish parent-child hierarchy
-     * 6. Call afterDeserialize hooks
-     */
-    deserialize(data: SaveData): Promise<void>;
-    $teardown(): Promise<void>;
-}
-export {};

package/dist/postProcessingFrameGraph-CaMgQzR-.js.map

@@ -1 +0,0 @@
-{"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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"}

package/dist/utils/entityProxy.d.ts

@@ -1,2 +0,0 @@
-import { GameEntityManager } from "../managers/entity.d.ts";
-export declare function createEntityProxy(entityManager: GameEntityManager): GameEntityManager & Record<string, unknown>;

package/dist/utils/raycast.d.ts

@@ -1,26 +0,0 @@
-import { AbstractMesh, Camera, PickingInfo, Ray, Scene, Vector3 } from '@babylonjs/core';
-import { GameEntity } from "../classes/entity.d.ts";
-import { GameEntityManager } from "../managers/entity.d.ts";
-export interface EntityPickResult {
-    entity: GameEntity;
-    point: Vector3;
-    distance: number;
-    normal: Vector3;
-    mesh: AbstractMesh;
-    pickingInfo: PickingInfo;
-}
-export interface EntityPickFilter {
-    type?: string;
-    tags?: string[];
-    predicate?: (entity: GameEntity) => boolean;
-}
-export declare class RaycastHelper {
-    private _entityManager;
-    constructor(entityManager: GameEntityManager);
-    pickEntity(scene: Scene, x: number, y: number, filter?: EntityPickFilter): EntityPickResult | null;
-    pickEntities(scene: Scene, x: number, y: number, filter?: EntityPickFilter): EntityPickResult[];
-    pickEntityWithRay(scene: Scene, ray: Ray, filter?: EntityPickFilter): EntityPickResult | null;
-    pickEntitiesWithRay(scene: Scene, ray: Ray, filter?: EntityPickFilter): EntityPickResult[];
-    pickEntityForward(scene: Scene, camera: Camera, maxDistance?: number, filter?: EntityPickFilter): EntityPickResult | null;
-    private _toEntityResult;
-}