PlacementInjectorSystem

Dependency injection system for the Grid Building Plugin. This system automatically handles: 1. Dependency Injection: Wires the PlacementContainer into all nodes that implement resolve_placement_dependencies(p_config: PlacementContainer) 2. Automatic Validation: Validates the complete setup after injection and reports any configuration issues via the container's logger No manual validation calls are required

• the injector handles everything automatically after dependency injection is complete. [b]Modes[/b] [b]Global mode[/b] (default, no [code]scope_root[/code]): injects the entire scene tree. Connects to [code]tree.node_added[/code] to catch dynamically added nodes. Falls back to [code][tree.root][/code] when [code]injection_roots[/code] is empty. Session auto-registration with the host is enabled by default. [b]Scoped mode[/b] ([code]scope_root[/code] set via [code]set_session_scope()[/code]): injects only the subtree under [code]scope_root[/code]. Does NOT connect to the global [code]node_added[/code] signal. The controller/bootstrap is responsible for explicitly registering the session with the host (see [code]host_created[/code] signal). This is the preferred path for split-screen, per-controller, and explicit code-built setups. [b]Responsibility Boundaries[/b] - [code]PlacementSession[/code]: owns mutable state, config, contexts, logger (SSOT) - [code]GridPlacementHost[/code]: owns stateless runtime services and dispatch - [code]PlacementInjectorSystem[/code]: wires scene-authored nodes around a session subtree; does NOT own the container, the session, or runtime logic [b]Setup Requirements:[/b]
• Assign a PlacementContainer resource to this injector
• Ensure PlacementLevelContext and PlacementOwner are properly configured before the injector runs (usually in _ready() methods)
• The injector will automatically validate after injection and log any issues Usage Example: ```gdscript # In your scene node: func resolve_placement_dependencies(p_config: PlacementContainer) -> void: _composition_container = p_config _logger = p_config.get_logger() # No validation call needed
• injector handles it automatically ``` [i]Nodes that implement resolve_placement_dependencies(p_config: PlacementContainer) will be injected automatically by this system.[/i]

Source: addons/grid_placement/systems/injection/placement_injector_system.gd

Syntax

class PlacementInjectorSystem extends PlacementSystemBase

Members