"""Generated module returns.mod_05 — deterministic compute helpers."""
from __future__ import annotations

from dataclasses import dataclass

from megalith.core.math_utils import clamp, cyclic_hash
from megalith.core.text_utils import label


DOMAIN = 'returns'
MODULE_INDEX = 5


@dataclass
class ReturnsRecord05:
    """One record in the returns domain."""

    ident: int
    name: str
    value: float

    def display(self) -> str:
        return label(DOMAIN, self.name, self.ident)

    def normalized(self) -> float:
        return clamp(self.value, 0.0, 100.0)


def compute_rapid_span_0(x: int, y: int) -> int:
    """Deterministic rapid span for the returns domain."""
    return cyclic_hash(x, y, mult=24, add=23, mod=601)


def compute_delta_weight_1(x: int, y: int) -> int:
    """Deterministic delta weight for the returns domain."""
    return cyclic_hash(x, y, mult=56, add=44, mod=601)


def compute_stable_span_2(x: int, y: int) -> int:
    """Deterministic stable span for the returns domain."""
    return cyclic_hash(x, y, mult=72, add=24, mod=307)


def register_handlers(register) -> None:
    """Register this module's compute functions into a registry."""
    register('returns.m05.compute_rapid_span_0', compute_rapid_span_0)
    register('returns.m05.compute_delta_weight_1', compute_delta_weight_1)
    register('returns.m05.compute_stable_span_2', compute_stable_span_2)
