@benev/math 0.2.0-0 → 0.2.0-1

package/s/{utils → tools}/spline.ts

@@ -1,15 +1,14 @@
 
-import {Scalar} from "../primitives/scalar.js"
-import {Vec2Array} from "../primitives/vec2.js"
+import {Scalar} from "./scalar.js"
+import {XyArray} from "../core/vec2.js"
 
 /** resolve a number within a linear spline. */
-export function linear(x: number, points: Vec2Array[]): number {
+export function linear(x: number, points: XyArray[]): number {
 	if (points.length < 2)
 		throw new Error("need at least two points, come on")
 
 	const [first] = points.at(0)!
 	const [last] = points.at(-1)!
-
 	x = Scalar.clamp(x, first, last)
 
 	for (let i = 0; i < points.length - 1; i++) {
@@ -26,11 +25,13 @@ export function linear(x: number, points: Vec2Array[]): number {
 }
 
 /** resolve a number within a catmull-rom spline, that's all smooth-like. */
-export function catmullRom(x: number, points: Vec2Array[]) {
+export function catmullRom(x: number, points: XyArray[]) {
 	if (points.length < 4)
 		throw new Error("need at least four points for this magic")
 
-	x = Scalar.clamp(x)
+	const [first] = points.at(0)!
+	const [last] = points.at(-1)!
+	x = Scalar.clamp(x, first, last)
 
 	// find the segment where 'x' fits
 	for (let i = 1; i < points.length - 2; i++) {
@@ -54,7 +55,7 @@ export const ez = {
 			throw new Error("need at least two points, come on")
 
 		const points2 = points.map(
-			(p, index): Vec2Array =>
+			(p, index): XyArray =>
 				[Scalar.clamp(index / (points.length - 1)), p]
 		)
 
@@ -67,10 +68,10 @@ namespace helpers {
 	/** internal big-brain maths for the catmull-rom implementation */
 	export function catmullRom(
 			t: number,
-			[,p0]: Vec2Array,
-			[,p1]: Vec2Array,
-			[,p2]: Vec2Array,
-			[,p3]: Vec2Array,
+			[,p0]: XyArray,
+			[,p1]: XyArray,
+			[,p2]: XyArray,
+			[,p3]: XyArray,
 		) {
 
 		const t2 = t * t

package/x/{primitives → core}/quat.d.ts

@@ -1,5 +1,5 @@
 import { Xyz } from "./vec3.js";
-export type QuatArray = [number, number, number, number];
+export type XyzwArray = [x: number, y: number, z: number, w: number];
 export type Xyzw = {
     x: number;
     y: number;
@@ -14,14 +14,19 @@ export declare class Quat {
     constructor(x: number, y: number, z: number, w: number);
     static new(x: number, y: number, z: number, w: number): Quat;
     static identity(): Quat;
-    static array(q: QuatArray): Quat;
-    static import({ x, y, z, w }: Xyzw): Quat;
-    static from(q: QuatArray | Xyzw): Quat;
+    static from(q: XyzwArray | Xyzw): Quat;
     static rotate_(pitch: number, yaw: number, roll: number): Quat;
     static rotate(vec: Xyz): Quat;
-    array(): QuatArray;
+    toJSON(): XyzwArray;
     toString(): string;
     clone(): Quat;
+    lengthSquared(): number;
+    length(): number;
+    isUnit(epsilon?: number): boolean;
+    ensureUnit(): this;
+    normalize(): this;
+    conjugate(): this;
+    invert(): this;
     transform_(x: number, y: number, z: number, w: number, global?: boolean): Quat;
     transform({ x, y, z, w }: Xyzw, global?: boolean): Quat;
     rotate_(pitch: number, yaw: number, roll: number, global?: boolean): Quat;

package/x/{primitives → core}/quat.js

@@ -15,16 +15,10 @@ export class Quat {
     static identity() {
         return new this(0, 0, 0, 1);
     }
-    static array(q) {
-        return new this(...q);
-    }
-    static import({ x, y, z, w }) {
-        return new this(x, y, z, w);
-    }
     static from(q) {
         return Array.isArray(q)
-            ? this.array(q)
-            : this.import(q);
+            ? new this(...q)
+            : new this(q.x, q.y, q.z, q.w);
     }
     static rotate_(pitch, yaw, roll) {
         return this.identity().rotate_(pitch, yaw, roll);
@@ -32,7 +26,7 @@ export class Quat {
     static rotate(vec) {
         return this.identity().rotate(vec);
     }
-    array() {
+    toJSON() {
         const { x, y, z, w } = this;
         return [x, y, z, w];
     }
@@ -40,12 +34,55 @@ export class Quat {
         return `(Quat x${this.x.toFixed(2)}, y${this.y.toFixed(2)}, z${this.z.toFixed(2)}, w${this.w.toFixed(2)})`;
     }
     clone() {
-        return new Quat(...this.array());
+        return new Quat(...this.toJSON());
+    }
+    lengthSquared() {
+        return this.x * this.x + this.y * this.y + this.z * this.z + this.w * this.w;
+    }
+    length() {
+        return Math.sqrt(this.lengthSquared());
+    }
+    isUnit(epsilon = 1e-6) {
+        return Math.abs(this.length() - 1) <= epsilon;
+    }
+    ensureUnit() {
+        if (!this.isUnit())
+            this.normalize();
+        return this;
+    }
+    normalize() {
+        const m = this.length();
+        if (!m) {
+            this.x = this.y = this.z = 0;
+            this.w = 1;
+            return this;
+        }
+        this.x /= m;
+        this.y /= m;
+        this.z /= m;
+        this.w /= m;
+        return this;
+    }
+    conjugate() {
+        this.x *= -1;
+        this.y *= -1;
+        this.z *= -1;
+        return this;
+    }
+    invert() {
+        const len2 = this.lengthSquared();
+        if (!len2)
+            return this.set_(0, 0, 0, 1);
+        this.x = -this.x / len2;
+        this.y = -this.y / len2;
+        this.z = -this.z / len2;
+        this.w = this.w / len2;
+        return this;
     }
     transform_(x, y, z, w, global = false) {
         if (global) {
-            const original = this.array();
-            return this.set_(x, y, z, w).multiply_(...original);
+            const original = this.clone();
+            return this.set_(x, y, z, w).multiply(original);
         }
         else {
             return this.multiply_(x, y, z, w);

package/x/core/quat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quat.js","sourceRoot":"","sources":["../../s/core/quat.ts"],"names":[],"mappings":"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"}

package/x/{primitives → core}/vec2.d.ts

@@ -1,29 +1,25 @@
-export type Vec2Array = [number, number];
+export type XyArray = [x: number, y: number];
 export type Xy = {
     x: number;
     y: number;
 };
-/** https://github.com/microsoft/TypeScript/issues/5863 */
-type TsHack<T> = {
-    new (...a: ConstructorParameters<typeof Vec2>): T;
-};
 export declare class Vec2 implements Xy {
     x: number;
     y: number;
     constructor(x: number, y: number);
-    static new<T extends Vec2>(this: TsHack<T>, x: number, y: number): T;
-    static zero<T extends Vec2>(this: TsHack<T>): T;
-    static all<T extends Vec2>(this: TsHack<T>, value: number): T;
-    static array<T extends Vec2>(this: TsHack<T>, v: Vec2Array): T;
-    static import<T extends Vec2>(this: TsHack<T>, { x, y }: Xy): T;
-    static from(v: Vec2Array | Xy): Vec2;
+    static new(x: number, y: number): Vec2;
+    static zero(): Vec2;
+    static all(value: number): Vec2;
+    static from(v: XyArray | Xy): Vec2;
     static magnitudeSquared(x: number, y: number): number;
     static magnitude(x: number, y: number): number;
     static average(...vectors: Xy[]): Vec2;
-    static min(...vecs: Vec2[]): Vec2;
-    static max(...vecs: Vec2[]): Vec2;
+    static min(...vecs: Xy[]): Vec2;
+    static max(...vecs: Xy[]): Vec2;
+    static fromAngle(radians: number): Vec2;
     clone(): Vec2;
-    array(): Vec2Array;
+    [Symbol.iterator](): Generator<number, void, unknown>;
+    toJSON(): XyArray;
     toString(): string;
     /** mutator */
     set_(x: number, y: number): this;
@@ -34,6 +30,8 @@ export declare class Vec2 implements Xy {
     rotation(): number;
     equals_(x: number, y: number): boolean;
     equals(...vecs: Xy[]): boolean;
+    near_(x: number, y: number, epsilon?: number): boolean;
+    near({ x, y }: Xy, epsilon?: number): boolean;
     dot_(x: number, y: number): number;
     dot({ x, y }: Xy): number;
     distanceSquared_(x: number, y: number): number;
@@ -65,7 +63,9 @@ export declare class Vec2 implements Xy {
     /** mutator */
     map(fn: (a: number, index: number) => number): this;
     /** mutator */
-    clamp(min: number, max: number): this;
+    clamp(min: Xy, max: Xy): this;
+    /** mutator */
+    clampBy(min: number, max: number): this;
     /** mutator */
     negate(): this;
     /** mutator */
@@ -105,10 +105,9 @@ export declare class Vec2 implements Xy {
     /** mutator */
     rotateAroundPoint_(x: number, y: number, radians: number): this;
     /** mutator */
-    rotateAroundPoint({ x, y }: Vec2, radians: number): this;
+    rotateAroundPoint({ x, y }: Xy, radians: number): this;
     /** mutator */
     smooth_(x: number, y: number, smoothing: number): this;
     /** mutator */
     smooth({ x, y }: Xy, smoothing: number): this;
 }
-export {};

package/x/{primitives → core}/vec2.js

@@ -1,4 +1,4 @@
-import { Scalar } from "./scalar.js";
+import { Scalar } from "../tools/scalar.js";
 export class Vec2 {
     x;
     y;
@@ -6,7 +6,6 @@ export class Vec2 {
         this.x = x;
         this.y = y;
     }
-    ///////////////////////////////////////////////////////////////////////
     static new(x, y) {
         return new this(x, y);
     }
@@ -16,16 +15,10 @@ export class Vec2 {
     static all(value) {
         return new this(value, value);
     }
-    static array(v) {
-        return new this(...v);
-    }
-    static import({ x, y }) {
-        return new this(x, y);
-    }
     static from(v) {
         return Array.isArray(v)
-            ? this.array(v)
-            : this.import(v);
+            ? new this(...v)
+            : new this(v.x, v.y);
     }
     static magnitudeSquared(x, y) {
         return (x * x) + (y * y);
@@ -39,16 +32,22 @@ export class Vec2 {
             .divideBy(vectors.length);
     }
     static min(...vecs) {
-        return new Vec2(Math.min(...vecs.map(v => v.x)), Math.min(...vecs.map(v => v.y)));
+        return new this(Math.min(...vecs.map(v => v.x)), Math.min(...vecs.map(v => v.y)));
     }
     static max(...vecs) {
-        return new Vec2(Math.max(...vecs.map(v => v.x)), Math.max(...vecs.map(v => v.y)));
+        return new this(Math.max(...vecs.map(v => v.x)), Math.max(...vecs.map(v => v.y)));
+    }
+    static fromAngle(radians) {
+        return new this(Math.cos(radians), Math.sin(radians));
     }
-    ///////////////////////////////////////////////////////////////////////
     clone() {
         return new Vec2(this.x, this.y);
     }
-    array() {
+    *[Symbol.iterator]() {
+        yield this.x;
+        yield this.y;
+    }
+    toJSON() {
         return [this.x, this.y];
     }
     toString() {
@@ -66,7 +65,6 @@ export class Vec2 {
         this.y = y;
         return this;
     }
-    ///////////////////////////////////////////////////////////////////////
     magnitudeSquared() {
         return Vec2.magnitudeSquared(this.x, this.y);
     }
@@ -83,6 +81,13 @@ export class Vec2 {
     equals(...vecs) {
         return vecs.every(({ x, y }) => this.equals_(x, y));
     }
+    near_(x, y, epsilon = 1e-6) {
+        return (Math.abs(this.x - x) <= epsilon &&
+            Math.abs(this.y - y) <= epsilon);
+    }
+    near({ x, y }, epsilon = 1e-6) {
+        return this.near_(x, y, epsilon);
+    }
     dot_(x, y) {
         return (this.x * x) + (this.y * y);
     }
@@ -106,12 +111,14 @@ export class Vec2 {
     angleBetween_(x, y) {
         const dot = this.dot_(x, y);
         const magnitudes = this.magnitude() * Vec2.magnitude(x, y);
-        return Math.acos(dot / magnitudes);
+        if (magnitudes === 0)
+            return 0;
+        const ratio = Scalar.clamp(dot / magnitudes, -1, 1);
+        return Math.acos(ratio);
     }
     angleBetween({ x, y }) {
         return this.angleBetween_(x, y);
     }
-    ///////////////////////////////////////////////////////////////////////
     /** mutator */
     normalize() {
         return this.divideBy(this.magnitude());
@@ -175,8 +182,15 @@ export class Vec2 {
     }
     /** mutator */
     clamp(min, max) {
-        const clamp = (val) => Math.max(min, Math.min(max, val));
-        return this.map(clamp);
+        this.x = Scalar.clamp(this.x, min.x, max.x);
+        this.y = Scalar.clamp(this.y, min.y, max.y);
+        return this;
+    }
+    /** mutator */
+    clampBy(min, max) {
+        this.x = Scalar.clamp(this.x, min, max);
+        this.y = Scalar.clamp(this.y, min, max);
+        return this;
     }
     /** mutator */
     negate() {
@@ -247,8 +261,10 @@ export class Vec2 {
     }
     /** mutator */
     divide_(x, y) {
-        this.x /= x;
-        this.y /= y;
+        if (x !== 0)
+            this.x /= x;
+        if (y !== 0)
+            this.y /= y;
         return this;
     }
     /** mutator */

package/x/core/vec2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vec2.js","sourceRoot":"","sources":["../../s/core/vec2.ts"],"names":[],"mappings":"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"}

package/x/{primitives → core}/vec3.d.ts

@@ -1,40 +1,38 @@
-export type Vec3Array = [number, number, number];
+export type XyzArray = [x: number, y: number, z: number];
 export type Xyz = {
     x: number;
     y: number;
     z: number;
 };
-/** https://github.com/microsoft/TypeScript/issues/5863 */
-type TsHack<T> = {
-    new (...a: ConstructorParameters<typeof Vec3>): T;
-};
 export declare class Vec3 {
     x: number;
     y: number;
     z: number;
     constructor(x: number, y: number, z: number);
-    static new<T extends Vec3>(this: TsHack<T>, x: number, y: number, z: number): T;
-    static zero<T extends Vec3>(this: TsHack<T>): T;
-    static all<T extends Vec3>(this: TsHack<T>, value: number): T;
-    static array<T extends Vec3>(this: TsHack<T>, v: Vec3Array): T;
-    static import<T extends Vec3>(this: TsHack<T>, { x, y, z }: Xyz): Vec3;
-    static from(v: Vec3Array | Xyz): Vec3;
+    static new(x: number, y: number, z: number): Vec3;
+    static zero(): Vec3;
+    static all(value: number): Vec3;
+    static from(v: XyzArray | Xyz): Vec3;
     static magnitudeSquared(x: number, y: number, z: number): number;
     static magnitude(x: number, y: number, z: number): number;
     static average(...vecs: Xyz[]): Vec3;
-    static min(...vecs: Vec3[]): Vec3;
-    static max(...vecs: Vec3[]): Vec3;
-    static hexColor(hex: string): Vec3;
+    static min(...vecs: Xyz[]): Vec3;
+    static max(...vecs: Xyz[]): Vec3;
+    static fromHex(hex: string): Vec3;
     clone(): Vec3;
-    array(): Vec3Array;
+    [Symbol.iterator](): Generator<number, void, unknown>;
+    toJSON(): XyzArray;
     toString(): string;
     set_(x: number, y: number, z: number): this;
     set({ x, y, z }: Xyz): this;
     magnitudeSquared(): number;
     magnitude(): number;
-    hexColor(): string;
+    /** rgb values from 0-1 */
+    toHex(): string;
     equals_(x: number, y: number, z: number): boolean;
     equals(...vecs: Xyz[]): boolean;
+    near_(x: number, y: number, z: number, epsilon?: number): boolean;
+    near({ x, y, z }: Xyz, epsilon?: number): boolean;
     distanceSquared_(x: number, y: number, z: number): number;
     distanceSquared({ x, y, z }: Xyz): number;
     distance_(x: number, y: number, z: number): number;
@@ -56,11 +54,11 @@ export declare class Vec3 {
     /** mutator */
     multiply_(x: number, y: number, z: number): this;
     /** mutator */
-    multiply(...vecs: Vec3[]): this;
+    multiply(...vecs: Xyz[]): this;
     /** mutator */
     divide_(x: number, y: number, z: number): this;
     /** mutator */
-    divide(...vecs: Vec3[]): this;
+    divide(...vecs: Xyz[]): this;
     /** mutator */
     half(): this;
     /** mutator */
@@ -74,6 +72,8 @@ export declare class Vec3 {
     /** mutator */
     addBy(delta: number): this;
     /** mutator */
+    subtractBy(delta: number): this;
+    /** mutator */
     multiplyBy(delta: number): this;
     /** mutator */
     divideBy(divisor: number): this;
@@ -100,7 +100,7 @@ export declare class Vec3 {
     /** mutator */
     projectOnto_(x: number, y: number, z: number): this;
     /** mutator */
-    projectOnto({ x, y, z }: Vec3): this;
+    projectOnto({ x, y, z }: Xyz): this;
     /** mutator */
     reflect_(x: number, y: number, z: number): this;
     /** mutator */
@@ -114,4 +114,3 @@ export declare class Vec3 {
     /** mutator */
     smooth({ x, y, z }: Xyz, smoothing: number): this;
 }
-export {};