"""Generated module catalog.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 = 'catalog'
MODULE_INDEX = 3


@dataclass
class CatalogRecord03:
    """One record in the catalog 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_delta_index_0(x: int, y: int) -> int:
    """Deterministic delta index for the catalog domain."""
    return cyclic_hash(x, y, mult=92, add=62, mod=101)


def compute_stable_span_1(x: int, y: int) -> int:
    """Deterministic stable span for the catalog domain."""
    return cyclic_hash(x, y, mult=6, add=55, mod=101)


def compute_lean_span_2(x: int, y: int) -> int:
    """Deterministic lean span for the catalog domain."""
    return cyclic_hash(x, y, mult=92, add=96, mod=307)


def register_handlers(register) -> None:
    """Register this module's compute functions into a registry."""
    register('catalog.m03.compute_delta_index_0', compute_delta_index_0)
    register('catalog.m03.compute_stable_span_1', compute_stable_span_1)
    register('catalog.m03.compute_lean_span_2', compute_lean_span_2)
