"""Abstract base for file parsers."""

from abc import abstractmethod
from pathlib import Path

from ..base_component import BaseComponent
from ...enumeration import ComponentEnum
from ...schema import FileChunk, FileNode


class BaseFileParser(BaseComponent):
    """Abstract base for file parsers. Subclasses implement `parse`."""

    component_type = ComponentEnum.FILE_PARSER

    def __init__(self, supported_extensions: list[str] | None = None, **kwargs):
        super().__init__(**kwargs)
        self.supported_extensions: list[str] = supported_extensions or []

    @abstractmethod
    async def parse(self, path: str | Path) -> tuple[FileNode, list[FileChunk]]:
        """Parse a file into (node, chunks)."""