from typing import List, Optional
from pathlib import Path

from docforge.model import Module, Project


def discover_module_paths(
    module_name: str,
    project_root: Path | None = None,
) -> List[str]:
    ...


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."""