"""LLM parser stub — disabled by feature flag in Phase 1."""
from __future__ import annotations

from typing import Any

from libs.schemas.types import ParserEventOutput


class LLMParserStub:
    """Placeholder for future LLM-based parser. Not operational in Phase 1."""

    def __init__(self, enabled: bool = False) -> None:
        self.enabled = enabled

    def parse(
        self,
        document_id: str,
        form_type: str,
        text: str,
        metadata: dict[str, Any] | None = None,
    ) -> ParserEventOutput | None:
        if not self.enabled:
            return None
        raise NotImplementedError("LLM parser is not implemented in Phase 1.")