from pathlib import Path
from typing import Dict, List

from docforge.models import Project, Module, DocObject


class MCPRenderer:
    """Renderer that emits MCP-native JSON resources from docforge models."""

    name: str

    def generate_sources(self, project: Project, out_dir: Path) -> None:
        """Generate MCP-compatible JSON resources and navigation for the project."""

    def _write_module(self, module: Module, modules_dir: Path) -> None:
        """Serialize a module into an MCP JSON resource."""

    def _render_module(self, module: Module) -> Dict:
        """Render a Module into MCP-friendly structured data."""

    def _render_object(self, obj: DocObject) -> Dict:
        """Recursively render a DocObject into structured MCP data."""

    @staticmethod
    def _json(data: Dict) -> str:
        """Serialize structured data to formatted JSON."""