add vec3 class

src/Nether/Common/Units/Vec3.php

@@ -0,0 +1,107 @@
+<?php
+
+namespace Nether\Common\Units;
+
+////////////////////////////////////////////////////////////////////////////////
+////////////////////////////////////////////////////////////////////////////////
+
+use Nether\Common;
+
+use Exception;
+
+////////////////////////////////////////////////////////////////////////////////
+////////////////////////////////////////////////////////////////////////////////
+
+class Vec3
+implements
+	Common\Interfaces\PropertyInfoPackage,
+	Common\Interfaces\ToArray,
+	Common\Interfaces\ToJSON {
+
+	#[Common\Meta\PropertyListable]
+	public int|float
+	$X;
+
+	#[Common\Meta\PropertyListable]
+	public int|float
+	$Y;
+
+	#[Common\Meta\PropertyListable]
+	public int|float
+	$Z;
+
+	use
+	Common\Package\PropertyInfoPackage,
+	Common\Package\ToArray,
+	Common\Package\ToJSON;
+
+	////////////////////////////////////////////////////////////////
+	////////////////////////////////////////////////////////////////
+
+	public function
+	__Construct(int|float $X=0, int|float $Y=0, int|float $Z=0) {
+
+		$this->X = $X;
+		$this->Y = $Y;
+		$this->Z = $Z;
+
+		return;
+	}
+
+	public function
+	__Get(string $Key):
+	mixed {
+
+		return match($Key) {
+			default => throw new Exception(sprintf(
+				'%s is not a thing on %s',
+				$Key, $this::class
+			))
+		};
+	}
+
+	////////////////////////////////////////////////////////////////
+	////////////////////////////////////////////////////////////////
+
+	public function
+	ClampX(int|float $Min, int|float $Max):
+	static {
+
+		$this->X = Common\Math::Clamp($this->X, $Min, $Max);
+
+		return $this;
+	}
+
+	public function
+	ClampY(int|float $Min, int|float $Max):
+	static {
+
+		$this->Y = Common\Math::Clamp($this->Y, $Min, $Max);
+
+		return $this;
+	}
+
+	public function
+	ClampZ(int|float $Min, int|float $Max):
+	static {
+
+		$this->Z = Common\Math::Clamp($this->Z, $Min, $Max);
+
+		return $this;
+	}
+
+	////////////////////////////////////////////////////////////////
+	// CONTEXT SWEETENER API ///////////////////////////////////////
+
+	// these methods exist purely to give the code creating vectors context
+	// what they are doing.
+
+
+	static public function
+	Coord(int|float $X=0, int|float $Y=0, int|float $Z=0):
+	static {
+
+		return new static($X, $Y, $Z);
+	}
+
+};