"""配置模式管理模块"""

from typing import Any

from apps.core.config.exceptions import ConfigValidationError

from .field import ConfigField


class ConfigSchema:
    def __init__(self) -> None:
        self._fields: dict[str, ConfigField] = {}

    def register(self, field: ConfigField) -> None:
        if field.name in self._fields:
            raise ValueError(f"配置字段 '{field.name}' 已存在")
        self._fields[field.name] = field

    def get_field(self, key: str) -> ConfigField | None:
        return self._fields.get(key)

    def validate_and_raise(self, config: dict[str, Any]) -> None:
        errors = [f"缺少必填配置项: {f.name}" for f in self._fields.values() if f.required and f.name not in config]
        if errors:
            raise ConfigValidationError(errors)

    def get_suggestions(self, key: str, max_suggestions: int = 5) -> list[str]:
        key_lower = key.lower()
        suggestions: list[str] = []
        for matcher in [
            lambda name: name.lower() == key_lower,
            lambda name: name.lower().startswith(key_lower),
            lambda name: key_lower in name.lower(),
        ]:
            if len(suggestions) >= max_suggestions:
                break
            for field_name in self._fields:
                if field_name not in suggestions and matcher(field_name):
                    suggestions.append(field_name)
                    if len(suggestions) >= max_suggestions:
                        break
        return suggestions