pipeworks_mud_mapper.callbacks

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)

See also

-, -, -

Submodules

• pipeworks_mud_mapper.callbacks.api_callbacks
• pipeworks_mud_mapper.callbacks.exit_callbacks
• pipeworks_mud_mapper.callbacks.file_callbacks
• pipeworks_mud_mapper.callbacks.map_callbacks
• pipeworks_mud_mapper.callbacks.ollama_callbacks
• pipeworks_mud_mapper.callbacks.ollama_generation_callbacks
• pipeworks_mud_mapper.callbacks.ollama_models_callbacks
• pipeworks_mud_mapper.callbacks.ollama_template_callbacks
• pipeworks_mud_mapper.callbacks.ollama_validation_callbacks
• pipeworks_mud_mapper.callbacks.room_callbacks
• pipeworks_mud_mapper.callbacks.theme_callbacks
• pipeworks_mud_mapper.callbacks.validation_callbacks
• pipeworks_mud_mapper.callbacks.workspace_callbacks

Functions

register_callbacks(app)

Register all callbacks with the Dash app.

Package Contents

pipeworks_mud_mapper.callbacks.register_callbacks(app)

Register all callbacks with the Dash app.

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

Parameters:

app (dash.Dash) – The Dash application instance.

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.