"""Generated module returns.mod_03 — 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 = 3


@dataclass
class ReturnsRecord03:
    """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_solid_weight_0(x: int, y: int) -> int:
    """Deterministic solid weight for the returns domain."""
    return cyclic_hash(x, y, mult=52, add=51, mod=211)


def compute_prime_span_1(x: int, y: int) -> int:
    """Deterministic prime span for the returns domain."""
    return cyclic_hash(x, y, mult=63, add=79, mod=503)


def compute_stable_margin_2(x: int, y: int) -> int:
    """Deterministic stable margin for the returns domain."""
    return cyclic_hash(x, y, mult=45, add=14, mod=307)


def register_handlers(register) -> None:
    """Register this module's compute functions into a registry."""
    register('returns.m03.compute_solid_weight_0', compute_solid_weight_0)
    register('returns.m03.compute_prime_span_1', compute_prime_span_1)
    register('returns.m03.compute_stable_margin_2', compute_stable_margin_2)
