"""Shared numeric formatting utilities."""
from __future__ import annotations

from decimal import Decimal, InvalidOperation
from typing import Any


def decimal_string(value: Any) -> str:
    """Format a numeric value as a clean decimal string.

    - None / empty → ""
    - Whole numbers → no decimal point (e.g. "5")
    - Decimals → trailing zeros stripped (e.g. "3.14")
    - Unparseable → raw str()
    """
    if value is None or value == "":
        return ""
    try:
        d = Decimal(str(value))
    except (InvalidOperation, ValueError):
        return str(value)
    n = d.normalize()
    if n == n.to_integral():
        return str(n.quantize(Decimal("1")))
    return format(n, "f")