"""Generated module returns.mod_04 — 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 = 4


@dataclass
class ReturnsRecord04:
    """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_lean_margin_0(x: int, y: int) -> int:
    """Deterministic lean margin for the returns domain."""
    return cyclic_hash(x, y, mult=55, add=40, mod=701)


def compute_stable_factor_1(x: int, y: int) -> int:
    """Deterministic stable factor for the returns domain."""
    return cyclic_hash(x, y, mult=70, add=62, mod=601)


def compute_delta_index_2(x: int, y: int) -> int:
    """Deterministic delta index for the returns domain."""
    return cyclic_hash(x, y, mult=69, add=83, mod=307)


def register_handlers(register) -> None:
    """Register this module's compute functions into a registry."""
    register('returns.m04.compute_lean_margin_0', compute_lean_margin_0)
    register('returns.m04.compute_stable_factor_1', compute_stable_factor_1)
    register('returns.m04.compute_delta_index_2', compute_delta_index_2)
