"""Pure domain contracts used before transport/model binding.""" from dataclasses import dataclass from typing import Literal SemanticClass = Literal[ "nid", "registration_number", "tax_id", "account_number", "pan", "date", "amount", "percentage", "generic_numeric", ] SourceScript = Literal["western", "arabic_indic", "extended_arabic_indic", "mixed"] @dataclass(frozen=True) class NumericPolicy: semantic_class: SemanticClass expected_length: int | None = None @dataclass(frozen=True) class BeamCandidate: text: str probability: float min_character_probability: float beam_margin: float = 1.0 character_confidences: tuple[float, ...] = () character_confidence_sources: tuple[str, ...] = () preprocessing_variant: str = "model_default" character_alternatives: tuple[tuple[tuple[str, float], ...], ...] = () @dataclass(frozen=True) class RankedCandidate: normalized_text: str source_script: SourceScript probability: float calibrated_confidence: float min_character_confidence: float beam_margin: float schema_valid: bool checksum_valid: bool | None character_confidences: tuple[float, ...] = () character_confidence_sources: tuple[str, ...] = () preprocessing_variant: str = "model_default" character_alternatives: tuple[tuple[tuple[str, float], ...], ...] = ()