from pathlib import Path

from docforge.models import Module, Project

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

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

    This is the only supported introspection backend in doc-forge.
    Converts Griffe results into `Project`, `Module`, and `DocObject` models.
    """

    def __init__(self) -> None: ...
    def load_project(
        self,
        module_paths: list[str],
        project_name: str | None = ...,
        skip_import_errors: bool | None = ...,
    ) -> Project:
        """Load a documentation project from Python modules."""

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