from typing import List, Optional

from docforge.model import Module, Project


class GriffeLoader:
    """Griffe-based introspection loader.

    This is the only supported introspection backend in doc-forge.
    """

    def __init__(self) -> None: ...

    def load_project(
        self,
        module_paths: List[str],
        project_name: Optional[str] = ...,
    ) -> Project:
        """Load a documentation project from Python modules."""

    def load_module(self, path: str) -> Module:
        """Load a single Python module by import path."""