linAlg::dot() method has return type too narrowly declared

[sneakyimp]

The function linAlg::dot needs to have its return type changed to include float and possible int and/or other scalar types. It is possible to multiply two vectors and get a scalar result. E.g., this code in matlab/octave returns a scalar, and blas returns a float:

octave:25> m1 = [1 2 3]
m1 =

   1   2   3

octave:26> m2 = [1;2;3]
m2 =

   1
   2
   3

octave:27> m1 * m2
ans = 14

This code should return 14:

$m1 = Np\vector::ar([1, 2, 3]);
echo "$m1\n";
$m2 = Np\vector::ar([1, 2, 3]);
echo "$m2\n";

$v = $m1->dot($m2);
echo "$v\n";

but due to the narrow return type restriction in linAlgb::dot, it throws this error:

PHP Fatal error:  Uncaught TypeError: Np\vector::dot(): Return value must be of type Np\matrix|Np\vector, float returned in /Users/sneakyimp/Desktop/biz/machine-learning/np/vendor/ghostjat/np/src/linAlgb/linAlg.php:34

Simply modifying the linAlg::dot function as follows should fix this particular error:

    /**
     *
     * get dot product of m.m | m.v | v.v
     *
     * @param \Np\matrix|\Np\vector $d
     * @return matrix|vector|float
     */
    public function dot(matrix|vector $d): matrix|vector|float {
        if ($this instanceof matrix) {
            if ($d instanceof matrix) {
                return $this->dotMatrix($d);
            }
            return $this->dotVector($d);
        }
        return blas::dot($this, $d);
    }