"""Generated module returns.mod_01 — 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 = 1


@dataclass
class ReturnsRecord01:
    """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_index_0(x: int, y: int) -> int:
    """Deterministic lean index for the returns domain."""
    return cyclic_hash(x, y, mult=85, add=93, mod=101)


def compute_swift_weight_1(x: int, y: int) -> int:
    """Deterministic swift weight for the returns domain."""
    return cyclic_hash(x, y, mult=89, add=29, mod=101)


def compute_lean_margin_2(x: int, y: int) -> int:
    """Deterministic lean margin for the returns domain."""
    return cyclic_hash(x, y, mult=82, add=21, mod=503)


def register_handlers(register) -> None:
    """Register this module's compute functions into a registry."""
    register('returns.m01.compute_lean_index_0', compute_lean_index_0)
    register('returns.m01.compute_swift_weight_1', compute_swift_weight_1)
    register('returns.m01.compute_lean_margin_2', compute_lean_margin_2)
