ona/source/coral/math.zig

const std = @import("std");

pub fn Int(comptime int: std.builtin.Type.Int) type {
	return @Type(.{.Int = int});
}

pub fn clamp(value: anytype, lower: anytype, upper: anytype) @TypeOf(value, lower, upper) {
	return @max(lower, @min(upper, value));
}

pub fn clamped_cast(comptime dest_int: std.builtin.Type.Int, value: anytype) Int(dest_int) {
	const Value = @TypeOf(value);

	return switch (@typeInfo(Value)) {
		.Int => |int| switch (int.signedness) {
			.signed => @intCast(clamp(value, min_int(dest_int), max_int(dest_int))),
			.unsigned => @intCast(@min(value, max_int(dest_int))),
		},

		else => @compileError("`" ++ @typeName(Value) ++ "` cannot be cast to an int"),
	};
}

pub fn max_int(comptime int: std.builtin.Type.Int) comptime_int {
	const bit_count = int.bits;

	if (bit_count == 0) return 0;

	return (1 << (bit_count - @intFromBool(int.signedness == .signed))) - 1;
}

pub fn min_int(comptime int: std.builtin.Type.Int) comptime_int {
	if (int.signedness == .unsigned) {
		return 0;
	}

	const bit_count = int.bits;

	if (bit_count == 0) return 0;

	return -(1 << (bit_count - 1));
}

pub fn wrap(value: anytype, lower: anytype, upper: anytype) @TypeOf(value, lower, upper) {
	const range = upper - lower;

	return if (range == 0) lower else lower + @mod((@mod((value - lower), range) + range), range);
}