mini_arcade_core.scenes.entity_blueprints
=========================================

.. py:module:: mini_arcade_core.scenes.entity_blueprints

.. autoapi-nested-parse::

   Helpers for building entities from data-driven scene config.



Functions
---------

.. autoapisummary::

   mini_arcade_core.scenes.entity_blueprints.deep_merge_dict
   mini_arcade_core.scenes.entity_blueprints.resolve_size_value
   mini_arcade_core.scenes.entity_blueprints.resolve_axis_value
   mini_arcade_core.scenes.entity_blueprints.resolve_transform_layout
   mini_arcade_core.scenes.entity_blueprints.build_entity_payload


Module Contents
---------------

.. py:function:: deep_merge_dict(base: dict[str, Any], overrides: dict[str, Any] | None = None) -> dict[str, Any]

   Deep-merge nested dictionaries, replacing non-dict leaves.


.. py:function:: resolve_size_value(raw_value: Any, *, axis_size: float) -> float

   Resolve one size component from config.


.. py:function:: resolve_axis_value(raw_value: Any, *, axis_size: float, entity_size: float, axis_name: str) -> float

   Resolve one axis position from a config value.

   Supported forms:
   - `12`
   - `{ value: 12 }`
   - `{ anchor: left|center|right, offset: 20 }`
   - `{ anchor: top|middle|bottom, offset: 20 }`
   - `{ relative: 0.5, offset: 0 }`


.. py:function:: resolve_transform_layout(transform: dict[str, Any] | None, *, viewport: tuple[float, float]) -> dict[str, Any]

   Resolve viewport-relative transform values into plain numeric center coordinates.


.. py:function:: build_entity_payload(template: dict[str, Any], *, viewport: tuple[float, float], overrides: dict[str, Any] | None = None) -> dict[str, Any]

   Merge a template with overrides and resolve transform layout.