"""Public surface of ``infrasynth.workflows``.

The exports are resolved lazily (PEP 562) so importing this package never
triggers Django model imports before the app registry is ready. Import from
here::

    from infrasynth.workflows import WorkflowEngine, DataValidatorRegistry, Workflow
"""

from __future__ import annotations

from importlib import import_module
from typing import Any

__all__ = [
    "DataValidatorProtocol",
    "DataValidatorRegistry",
    "NodeAssignment",
    "Transition",
    "Workflow",
    "WorkflowAwareModel",
    "WorkflowEngine",
    "WorkflowInstance",
    "WorkflowNode",
    "WorkflowObserver",
]

# public name -> module (relative to the ``infrasynth`` package) that defines it
_EXPORTS: dict[str, str] = {
    "DataValidatorProtocol": "workflows.validators",
    "DataValidatorRegistry": "workflows.validators",
    "NodeAssignment": "workflows.models",
    "Transition": "workflows.models",
    "Workflow": "workflows.models",
    "WorkflowAwareModel": "workflows.models",
    "WorkflowEngine": "workflows.engine",
    "WorkflowInstance": "workflows.models",
    "WorkflowNode": "workflows.models",
    "WorkflowObserver": "workflows.models",
}


def __getattr__(name: str) -> Any:
    module_path = _EXPORTS.get(name)
    if module_path is not None:
        return getattr(import_module(f"infrasynth.{module_path}"), name)
    # Let ``infrasynth.<app>.<submodule>`` resolve as usual.
    try:
        return import_module(f"{__name__}.{name}")
    except ModuleNotFoundError as exc:
        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from exc


def __dir__() -> list[str]:
    return sorted(set(__all__) | set(globals()))