feat: Turtle Position Vector ( Fixes #274, Fixes #275, Fixes #276 )

Also adding docs

Author: StartAutomating

Types/Turtle/get_Position.ps1

@@ -1,4 +1,14 @@
+<#
+.SYNOPSIS
+    Gets the Turtle's position
+.DESCRIPTION
+    Gets the current position of the turtle as a vector.
+#>
+[OutputType([Numerics.Vector2])]
+param()
 if (-not $this.'.Position') {
-    $this |  Add-Member -MemberType NoteProperty -Force -Name '.Position' -Value ([pscustomobject]@{ X = 0; Y = 0 })
+    $this |  Add-Member -MemberType NoteProperty -Force -Name '.Position' -Value (
+        [Numerics.Vector2]::new(0,0)
+    )
 }
 return $this.'.Position'

Types/Turtle/set_Position.ps1

@@ -1,23 +1,46 @@
+<#
+.SYNOPSIS
+    Sets the Turtle's position
+.DESCRIPTION
+    Sets the position of the Turtle and updates its minimum and maximum.
+    
+    This should really not be done directly - the position should be updated as the Turtle moves.
+.NOTES
+    Changing the position outside of the turtle will probably not work how you would expect.
+#>
 param([double[]]$xy)
+# break apart the components
 $x, $y = $xy
+# and add a position if we do not have one.
 if (-not $this.'.Position') {
-    $this |  Add-Member -MemberType NoteProperty -Force -Name '.Position' -Value ([pscustomobject]@{ X = 0; Y = 0 })
+    $this |  Add-Member -MemberType NoteProperty -Force -Name '.Position' -Value ([Numerics.Vector2]@{ X = 0; Y = 0 })
 }
+# Modify the position without creating a new object
 $this.'.Position'.X += $x
 $this.'.Position'.Y += $y
+# And readback our new position
 $posX, $posY = $this.'.Position'.X, $this.'.Position'.Y
+# If we have no .Minimum
 if (-not $this.'.Minimum') {
-    $this |  Add-Member -MemberType NoteProperty -Force -Name '.Minimum' -Value ([pscustomobject]@{ X = 0; Y = 0 })
-}
-if (-not $this.'.Maximum') {
-    $this |  Add-Member -MemberType NoteProperty -Force -Name '.Maximum' -Value ([pscustomobject]@{ X = 0; Y = 0 })
+    # create one.
+    $this |  Add-Member -MemberType NoteProperty -Force -Name '.Minimum' -Value ([Numerics.Vector2]@{ X = 0; Y = 0 })
 }
+
+# Then check if we need to update our minimum point.
 if ($posX -lt $this.'.Minimum'.X) {
     $this.'.Minimum'.X = $posX
 }
 if ($posY -lt $this.'.Minimum'.Y) {
     $this.'.Minimum'.Y = $posY
 }
+
+# If we have no .Maximum
+if (-not $this.'.Maximum') {
+    # create one.
+    $this |  Add-Member -MemberType NoteProperty -Force -Name '.Maximum' -Value ([Numerics.Vector2]@{ X = 0; Y = 0 })
+}
+
+# Then update our maximum point
 if ($posX -gt $this.'.Maximum'.X) {
     $this.'.Maximum'.X = $posX
 }