feat: type/number: add Clamp255Float64(), Utoi()

Author: grokify

type/number/constraints.go

@@ -12,3 +12,14 @@ type Signed interface {
 type Unsigned interface {
 	~uint | ~uint8 | ~uint16 | ~uint32 | ~uint64
 }
+
+// Clamp255Float64 ensures values are within 0–255 range
+func Clamp255Float64(v float64) float64 {
+	if v < 0 {
+		return 0
+	}
+	if v > 255 {
+		return 255
+	}
+	return v
+}

type/number/numconv.go

@@ -114,3 +114,11 @@ func U64toi64(u uint64) (int64, error) {
 		return int64(u), nil
 	}
 }
+
+func Utoi(u uint) (int, error) {
+	if u > math.MaxInt {
+		return 0, errorsutil.Wrapf(ErrOverflow, "uint value (%d) overflows int", u)
+	} else {
+		return int(u), nil
+	}
+}