pipeworks_mud_mapper.callbacks
==============================

.. py:module:: pipeworks_mud_mapper.callbacks

.. autoapi-nested-parse::

   Callback modules for PipeWorks MUD Mapper.

   This module provides Dash callbacks organized by functionality.
   Callbacks are thin orchestrators that:

   1. Extract data from component state
   2. Call service functions for business logic
   3. Return updated state to components

   Architecture
   ------------
   Callbacks are organized into functional modules:

   **file_callbacks**
       File management: load, save, new map, export.
       Modal dialogs for zone creation.

   **map_callbacks**
       Map visualization and interaction.
       Room selection via click events.

   **room_callbacks**
       Room CRUD operations.
       Form population and validation.

   **exit_callbacks**
       Exit checkbox handling.
       Bidirectional exit management.

   **ollama_callbacks**
       LLM integration via local Ollama server.
       Model selection, prompt handling, description generation.

   **validation_callbacks**
       Map validation checks.
       Results display and report generation.

   **workspace_callbacks**
       Workspace panel utilities (SQLite overview, health, etc.).

   Registration
   ------------
   Callbacks are registered when their modules are imported.
   The app.py module imports all callback modules after
   initializing the Dash app::

       from pipeworks_mud_mapper.callbacks import register_callbacks

       app = dash.Dash(...)
       register_callbacks(app)

   .. seealso:: :py:obj:`-`, :py:obj:`-`, :py:obj:`-`



Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/pipeworks_mud_mapper/callbacks/api_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/exit_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/file_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/map_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/ollama_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/ollama_generation_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/ollama_models_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/ollama_template_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/ollama_validation_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/room_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/theme_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/validation_callbacks/index
   /autoapi/pipeworks_mud_mapper/callbacks/workspace_callbacks/index


Functions
---------

.. autoapisummary::

   pipeworks_mud_mapper.callbacks.register_callbacks


Package Contents
----------------

.. py:function:: register_callbacks(app)

   Register all callbacks with the Dash app.

   This function is called after app initialization to ensure
   all callbacks are properly registered.

   :param app: The Dash application instance.
   :type app: :py:class:`dash.Dash`

   .. admonition:: Notes

      In Dash, callbacks are registered via the @callback decorator
      which uses the global app context. Importing the callback modules
      is sufficient to register them, but this function provides an
      explicit registration point for clarity.