# base.py
from __future__ import annotations

import logging
from abc import ABC, abstractmethod
from typing import Optional

import numpy as np

ArrayLike = np.ndarray


class SpectrumComponent(ABC):
    """
    Base class for multiplicative components of beta-spectrum.

    Parameters
    ----------
    logger : logging.Logger, optional
        Logger instance for debug/info output. If None, logging is disabled.
        Opt-in design: components are silent by default for library use.
    """

    def __init__(self, logger: Optional["logging.Logger"] = None) -> None:
        self._logger = logger
        self._log_component_info()

    def _log_component_info(self) -> None:
        """Log component identification at INFO level."""
        if self._logger is None:
            return
        class_name = self.__class__.__name__
        self._logger.info("Component initialized: %s", class_name)

    @abstractmethod
    def __call__(self, W: ArrayLike) -> ArrayLike:
        """
        Evaluate component at total energy W (in m_e units).
        """
        pass