pipeworks_mud_mapper.services.state.manager
===========================================

.. py:module:: pipeworks_mud_mapper.services.state.manager

.. autoapi-nested-parse::

   Zone state manager entry point.

   This module routes high-level zone actions to specialized handlers.
   Callbacks should use `apply_zone_action` as the single entrypoint for
   mutating `current-zone-data`.



Functions
---------

.. autoapisummary::

   pipeworks_mud_mapper.services.state.manager.apply_zone_action


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

.. py:function:: apply_zone_action(zone_data, action)

   Apply a zone action using the appropriate handler.

   :param zone_data: Current zone data to mutate.
   :type zone_data: :py:class:`dict | None`
   :param action: Action describing the desired mutation.
   :type action: :py:class:`ZoneAction`

   :returns: The result of the action, including updated zone data and effects.
   :rtype: :py:class:`ZoneTransition`