@benev/math 0.2.0 → 0.3.0-2

package/LICENSE

@@ -1,7 +1,7 @@
 
 MIT License
 
-Copyright (c) 2025 Chase Moskal
+Copyright (c) 2026 Chase Moskal
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -17,14 +17,14 @@
     // allocate a single vector instance
     const vector = new Vec2(0, 0)
       .add({x: 1, y: 2})
-      .multiplyBy(2)
+      .mulBy(2)
     ```
 - **explicit cloning.**  
-    use `.clone()` to avoid mutating the original.  
+    use `.dup()` to avoid mutating the original.  
     ```ts
     // modify a clone (not the original)
     const vector2 = vector
-      .clone()
+      .dup()
       .normalize()
     ```
 - **underscore-suffixed methods take direct args.**  

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@benev/math",
-	"version": "0.2.0",
+	"version": "0.3.0-2",
 	"description": "game math toolkit",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
@@ -22,14 +22,14 @@
 		"count": "find s -path '*/_archive' -prune -o -name '*.ts' -exec wc -l {} +"
 	},
 	"dependencies": {
-		"@e280/stz": "^0.2.15",
+		"@e280/stz": "^0.2.26",
 		"simplex-noise": "^4.0.3"
 	},
 	"devDependencies": {
-		"@e280/science": "^0.1.4",
-		"@e280/scute": "^0.1.2",
+		"@e280/science": "^0.1.8",
+		"@e280/scute": "^0.3.0-1",
 		"npm-run-all": "^4.1.5",
-		"typescript": "^5.9.3"
+		"typescript": "^6.0.2"
 	},
 	"repository": {
 		"type": "git",

package/s/{tools → core}/circular.ts

@@ -6,7 +6,7 @@ const circle = 2 * Math.PI
 export class Circular {
 	constructor(public x: number) {}
 
-	clone() {
+	dup() {
 		return new Circular(this.x)
 	}
 

package/s/core/quat.ts

@@ -34,16 +34,20 @@ export class Quat {
 		return this.identity().rotate(vec)
 	}
 
-	toJSON(): XyzwArray {
+	array(): XyzwArray {
 		const {x, y, z, w} = this
 		return [x, y, z, w]
 	}
 
+	toJSON(): XyzwArray {
+		return this.array()
+	}
+
 	toString() {
 		return `(Quat x${this.x.toFixed(2)}, y${this.y.toFixed(2)}, z${this.z.toFixed(2)}, w${this.w.toFixed(2)})`
 	}
 
-	clone() {
+	dup() {
 		return new Quat(...this.toJSON())
 	}
 
@@ -97,11 +101,11 @@ export class Quat {
 
 	transform_(x: number, y: number, z: number, w: number, global = false) {
 		if (global) {
-			const original = this.clone()
-			return this.set_(x, y, z, w).multiply(original)
+			const original = this.dup()
+			return this.set_(x, y, z, w).mul(original)
 		}
 		else {
-			return this.multiply_(x, y, z, w)
+			return this.mul_(x, y, z, w)
 		}
 	}
 
@@ -154,7 +158,7 @@ export class Quat {
 		return this
 	}
 
-	multiply_(x2: number, y2: number, z2: number, w2: number): Quat {
+	mul_(x2: number, y2: number, z2: number, w2: number): Quat {
 		const {x, y, z, w} = this
 		this.x = w * x2 + x * w2 + y * z2 - z * y2
 		this.y = w * y2 - x * z2 + y * w2 + z * x2
@@ -163,8 +167,8 @@ export class Quat {
 		return this
 	}
 
-	multiply(...quats: Quat[]) {
-		for (const {x, y, z, w} of quats) this.multiply_(x, y, z, w)
+	mul(...quats: Quat[]) {
+		for (const {x, y, z, w} of quats) this.mul_(x, y, z, w)
 		return this
 	}
 }

package/s/{tools → core}/scalar.ts

@@ -6,7 +6,7 @@ export class Scalar {
 		return new this(x)
 	}
 
-	clone() {
+	dup() {
 		return new Scalar(this.x)
 	}
 
@@ -47,7 +47,7 @@ export class Scalar {
 		return this
 	}
 
-	subtract(...nums: number[]) {
+	sub(...nums: number[]) {
 		for (const n of nums)
 			this.x -= n
 		return this

package/s/core/vec2.ts

@@ -1,5 +1,5 @@
 
-import {Scalar} from "../tools/scalar.js"
+import {Scalar} from "./scalar.js"
 
 export type XyArray = [x: number, y: number]
 export type Xy = {x: number, y: number}
@@ -39,7 +39,7 @@ export class Vec2 implements Xy {
 	static average(...vectors: Xy[]) {
 		return this.zero()
 			.add(...vectors)
-			.divideBy(vectors.length)
+			.divBy(vectors.length)
 	}
 
 	static min(...vecs: Xy[]) {
@@ -63,7 +63,7 @@ export class Vec2 implements Xy {
 		)
 	}
 
-	clone() {
+	dup() {
 		return new Vec2(this.x, this.y)
 	}
 
@@ -72,10 +72,14 @@ export class Vec2 implements Xy {
 		yield this.y
 	}
 
-	toJSON(): XyArray {
+	array(): XyArray {
 		return [this.x, this.y]
 	}
 
+	toJSON(): XyArray {
+		return this.array()
+	}
+
 	toString() {
 		return `(Vec2 x${this.x.toFixed(2)}, y${this.y.toFixed(2)})`
 	}
@@ -168,17 +172,17 @@ export class Vec2 implements Xy {
 
 	/** mutator */
 	normalize() {
-		return this.divideBy(this.magnitude())
+		return this.divBy(this.magnitude())
 	}
 
 	/** mutator */
 	half() {
-		return this.divideBy(2)
+		return this.divBy(2)
 	}
 
 	/** mutator */
 	double() {
-		return this.multiplyBy(2)
+		return this.mulBy(2)
 	}
 
 	/** mutator */
@@ -206,7 +210,7 @@ export class Vec2 implements Xy {
 	clampMagnitude(max: number) {
 		const mag = this.magnitude()
 		if (mag > max)
-			this.normalize().multiplyBy(max)
+			this.normalize().mulBy(max)
 		return this
 	}
 
@@ -272,21 +276,21 @@ export class Vec2 implements Xy {
 	}
 
 	/** mutator */
-	subtractBy(delta: number) {
+	subBy(delta: number) {
 		this.x -= delta
 		this.y -= delta
 		return this
 	}
 
 	/** mutator */
-	multiplyBy(coefficient: number) {
+	mulBy(coefficient: number) {
 		this.x *= coefficient
 		this.y *= coefficient
 		return this
 	}
 
 	/** mutator */
-	divideBy(divisor: number) {
+	divBy(divisor: number) {
 		if (divisor === 0) return this
 		this.x /= divisor
 		this.y /= divisor
@@ -309,41 +313,41 @@ export class Vec2 implements Xy {
 	}
 
 	/** mutator */
-	subtract_(x: number, y: number) {
+	sub_(x: number, y: number) {
 		this.x -= x
 		this.y -= y
 		return this
 	}
 
 	/** mutator */
-	subtract(...vecs: Xy[]) {
-		for (const {x, y} of vecs) this.subtract_(x, y)
+	sub(...vecs: Xy[]) {
+		for (const {x, y} of vecs) this.sub_(x, y)
 		return this
 	}
 
 	/** mutator */
-	multiply_(x: number, y: number) {
+	mul_(x: number, y: number) {
 		this.x *= x
 		this.y *= y
 		return this
 	}
 
 	/** mutator */
-	multiply(...vecs: Xy[]) {
-		for (const {x, y} of vecs) this.multiply_(x, y)
+	mul(...vecs: Xy[]) {
+		for (const {x, y} of vecs) this.mul_(x, y)
 		return this
 	}
 
 	/** mutator */
-	divide_(x: number, y: number) {
+	div_(x: number, y: number) {
 		if (x !== 0) this.x /= x
 		if (y !== 0) this.y /= y
 		return this
 	}
 
 	/** mutator */
-	divide(...vecs: Xy[]) {
-		for (const {x, y} of vecs) this.divide_(x, y)
+	div(...vecs: Xy[]) {
+		for (const {x, y} of vecs) this.div_(x, y)
 		return this
 	}
 

package/s/core/vec3.ts

@@ -1,5 +1,5 @@
 
-import {Scalar} from "../tools/scalar.js"
+import {Scalar} from "./scalar.js"
 
 export type XyzArray = [x: number, y: number, z: number]
 export type Xyz = {x: number, y: number, z: number}
@@ -40,7 +40,7 @@ export class Vec3 {
 	static average(...vecs: Xyz[]) {
 		return this.zero()
 			.add(...vecs)
-			.divideBy(vecs.length)
+			.divBy(vecs.length)
 	}
 
 	static min(...vecs: Xyz[]) {
@@ -70,7 +70,7 @@ export class Vec3 {
 		}
 	}
 
-	clone() {
+	dup() {
 		return new Vec3(this.x, this.y, this.z)
 	}
 
@@ -80,10 +80,14 @@ export class Vec3 {
 		yield this.z
 	}
 
-	toJSON(): XyzArray {
+	array(): XyzArray {
 		return [this.x, this.y, this.z]
 	}
 
+	toJSON(): XyzArray {
+		return this.array()
+	}
+
 	toString() {
 		return `(Vec3 x${this.x.toFixed(2)}, y${this.y.toFixed(2)}, z${this.z.toFixed(2)})`
 	}
@@ -204,7 +208,7 @@ export class Vec3 {
 	}
 
 	/** mutator */
-	subtract_(x: number, y: number, z: number) {
+	sub_(x: number, y: number, z: number) {
 		this.x -= x
 		this.y -= y
 		this.z -= z
@@ -212,13 +216,13 @@ export class Vec3 {
 	}
 
 	/** mutator */
-	subtract(...vecs: Xyz[]) {
-		for (const {x, y, z} of vecs) this.subtract_(x, y, z)
+	sub(...vecs: Xyz[]) {
+		for (const {x, y, z} of vecs) this.sub_(x, y, z)
 		return this
 	}
 
 	/** mutator */
-	multiply_(x: number, y: number, z: number) {
+	mul_(x: number, y: number, z: number) {
 		this.x *= x
 		this.y *= y
 		this.z *= z
@@ -226,13 +230,13 @@ export class Vec3 {
 	}
 
 	/** mutator */
-	multiply(...vecs: Xyz[]) {
-		for (const {x, y, z} of vecs) this.multiply_(x, y, z)
+	mul(...vecs: Xyz[]) {
+		for (const {x, y, z} of vecs) this.mul_(x, y, z)
 		return this
 	}
 
 	/** mutator */
-	divide_(x: number, y: number, z: number) {
+	div_(x: number, y: number, z: number) {
 		if (x !== 0) this.x /= x
 		if (y !== 0) this.y /= y
 		if (z !== 0) this.z /= z
@@ -240,8 +244,8 @@ export class Vec3 {
 	}
 
 	/** mutator */
-	divide(...vecs: Xyz[]) {
-		for (const {x, y, z} of vecs) this.divide_(x, y, z)
+	div(...vecs: Xyz[]) {
+		for (const {x, y, z} of vecs) this.div_(x, y, z)
 		return this
 	}
 
@@ -249,12 +253,12 @@ export class Vec3 {
 
 	/** mutator */
 	half() {
-		return this.divideBy(2)
+		return this.divBy(2)
 	}
 
 	/** mutator */
 	double() {
-		return this.multiplyBy(2)
+		return this.mulBy(2)
 	}
 
 	/** mutator */
@@ -310,7 +314,7 @@ export class Vec3 {
 	}
 
 	/** mutator */
-	subtractBy(delta: number) {
+	subBy(delta: number) {
 		this.x -= delta
 		this.y -= delta
 		this.z -= delta
@@ -318,7 +322,7 @@ export class Vec3 {
 	}
 
 	/** mutator */
-	multiplyBy(delta: number) {
+	mulBy(delta: number) {
 		this.x *= delta
 		this.y *= delta
 		this.z *= delta
@@ -326,7 +330,7 @@ export class Vec3 {
 	}
 
 	/** mutator */
-	divideBy(divisor: number) {
+	divBy(divisor: number) {
 		if (divisor === 0) return this
 		this.x /= divisor
 		this.y /= divisor
@@ -336,13 +340,13 @@ export class Vec3 {
 
 	/** mutator */
 	normalize() {
-		return this.divideBy(this.magnitude())
+		return this.divBy(this.magnitude())
 	}
 
 	/** mutator */
 	clampMagnitude(max: number) {
 		const magnitude = this.magnitude()
-		if (magnitude > max) this.normalize().multiplyBy(max)
+		if (magnitude > max) this.normalize().mulBy(max)
 		return this
 	}
 

package/s/core/vec4.ts

@@ -23,7 +23,7 @@ export class Vec4 {
 			: new this(v.x, v.y, v.z, v.w)
 	}
 
-	clone() {
+	dup() {
 		return new Vec4(this.x, this.y, this.z, this.w)
 	}
 
@@ -34,11 +34,15 @@ export class Vec4 {
 		yield this.w
 	}
 
-	toJSON(): XyzwArray {
+	array(): XyzwArray {
 		const {x, y, z, w} = this
 		return [x, y, z, w]
 	}
 
+	toJSON(): XyzwArray {
+		return this.array()
+	}
+
 	toString() {
 		return `(Vec4 x${this.x.toFixed(2)}, y${this.y.toFixed(2)}, z${this.z.toFixed(2)}, w${this.w.toFixed(2)})`
 	}

package/s/index.ts

@@ -1,27 +1,22 @@
 
+export * from "./core/circular.js"
 export * from "./core/quat.js"
+export * from "./core/scalar.js"
 export * from "./core/vec2.js"
 export * from "./core/vec3.js"
 export * from "./core/vec4.js"
 
 export * from "./tools/angles.js"
-export * from "./tools/circular.js"
 export * from "./tools/noise.js"
 export * from "./tools/randy.js"
-export * from "./tools/scalar.js"
+export * from "./tools/make-noise.js"
 export * as spline from "./tools/spline.js"
 
 export * from "./optimizers/hash-map.js"
 export * from "./optimizers/hash-set.js"
 export * from "./optimizers/zen.js"
 
-export * from "./physics/2d/collide2d.js"
-export * as collide2d from "./physics/2d/collide2d.js"
-export * from "./physics/2d/intersect2d.js"
-export * as intersect2d from "./physics/2d/intersect2d.js"
+export * from "./physics/index.js"
 
-export * from "./shapes/2d/index.js"
-export * as shapes2d from "./shapes/2d/index.js"
-export * from "./shapes/3d/index.js"
-export * as shapes3d from "./shapes/3d/index.js"
+export * from "./shapes/index.js"
 

package/s/optimizers/hash-map.ts

@@ -1,8 +1,8 @@
 
-import {MapG} from "@e280/stz"
+import {GMap} from "@e280/stz"
 
 export class HashMap<Key, Value> {
-	#map = new MapG<string, [Key, Value]>
+	#map = new GMap<string, [Key, Value]>
 
 	constructor(
 			private hash: (x: Key) => string,

package/s/optimizers/zen.ts

@@ -1,5 +1,5 @@
 
-import {MapG} from "@e280/stz"
+import {GMap} from "@e280/stz"
 import {Vec2} from "../core/vec2.js"
 import {Rect} from "../shapes/2d/rect.js"
 import {rectVsRect} from "../physics/2d/collide2d.js"
@@ -32,7 +32,7 @@ export class ZenZone<X> {
 }
 
 export class ZenGrid<X> {
-	#zones = new MapG<string, ZenZone<X>>()
+	#zones = new GMap<string, ZenZone<X>>()
 
 	constructor(private zoneExtent: Vec2) {}
 
@@ -124,14 +124,14 @@ export class ZenGrid<X> {
 		return new Vec2(
 			Math.floor(point.x / this.zoneExtent.x),
 			Math.floor(point.y / this.zoneExtent.y),
-		).multiply(this.zoneExtent)
+		).mul(this.zoneExtent)
 	}
 
 	#obtainZone(zoneCorner: Vec2) {
 		const hash = this.#hash(zoneCorner)
 		return this.#zones.guarantee(hash, () => new ZenZone(
 			hash,
-			zoneCorner.clone().add(this.zoneExtent.clone().half()),
+			zoneCorner.dup().add(this.zoneExtent.dup().half()),
 			this.zoneExtent,
 		))
 	}

package/s/physics/2d/collide2d.barrel.ts

@@ -0,0 +1,3 @@
+
+export * as collide2d from "./collide2d.js"
+

package/s/physics/2d/collide2d.ts

@@ -1,7 +1,7 @@
 
 import {Vec2} from "../../core/vec2.js"
+import {Scalar} from "../../core/scalar.js"
 import {Rect} from "../../shapes/2d/rect.js"
-import {Scalar} from "../../tools/scalar.js"
 import {Circle} from "../../shapes/2d/circle.js"
 
 export function pointVsRect(point: Vec2, box: Rect) {
@@ -35,7 +35,7 @@ export function rectVsCircle(rect: Rect, circle: Circle) {
 		Scalar.clamp(circle.center.x, rect.min.x, rect.max.x),
 		Scalar.clamp(circle.center.y, rect.min.y, rect.max.y),
 	)
-	const difference = circle.center.clone().subtract(clamped)
+	const difference = circle.center.dup().sub(clamped)
 	const distanceSquared = (difference.x ** 2) + (difference.y ** 2)
 	const radiusSquared = circle.radius ** 2
 	return distanceSquared <= radiusSquared

package/s/physics/2d/intersect2d.barrel.ts

@@ -0,0 +1,3 @@
+
+export * as intersect2d from "./intersect2d.js"
+

package/s/physics/2d/intersect2d.ts

@@ -1,9 +1,9 @@
 
 import {Vec2} from "../../core/vec2.js"
+import {Scalar} from "../../core/scalar.js"
 import {Rect} from "../../shapes/2d/rect.js"
-import {Scalar} from "../../tools/scalar.js"
+import {collide2d} from "./collide2d.barrel.js"
 import {Circle} from "../../shapes/2d/circle.js"
-import {rectVsCircle, rectVsRect} from "./collide2d.js"
 
 export class Intersection {
 	constructor(
@@ -14,8 +14,8 @@ export class Intersection {
 	) {}
 }
 
-export function intersectRectVsRect(a: Rect, b: Rect) {
-	if (!rectVsRect(a, b)) return null
+export function rectVsRect(a: Rect, b: Rect) {
+	if (!collide2d.rectVsRect(a, b)) return null
 
 	const overlapX = Math.min(a.max.x - b.min.x, b.max.x - a.min.x)
 	const overlapY = Math.min(a.max.y - b.min.y, b.max.y - a.min.y)
@@ -33,30 +33,30 @@ export function intersectRectVsRect(a: Rect, b: Rect) {
 		? new Vec2(bCenter.x > aCenter.x ? -1 : 1, 0)
 		: new Vec2(0, bCenter.y > aCenter.y ? -1 : 1)
 
-	const normalB = normalA.clone().multiplyBy(-1)
+	const normalB = normalA.dup().mulBy(-1)
 
 	return new Intersection(contactPoint, depth, normalA, normalB)
 }
 
-export function intersectRectVsCircle(rect: Rect, circle: Circle) {
-	if (!rectVsCircle(rect, circle)) return null
+export function rectVsCircle(rect: Rect, circle: Circle) {
+	if (!collide2d.rectVsCircle(rect, circle)) return null
 
 	const clamped = new Vec2(
 		Scalar.clamp(circle.center.x, rect.min.x, rect.max.x),
 		Scalar.clamp(circle.center.y, rect.min.y, rect.max.y),
 	)
-	const difference = circle.center.clone().subtract(clamped)
+	const difference = circle.center.dup().sub(clamped)
 	const distance = difference.magnitude()
 	const depth = circle.radius - distance
 
 	const contactPoint = clamped
 	const normalA = difference.normalize()
-	const normalB = normalA.clone().multiplyBy(-1)
+	const normalB = normalA.dup().mulBy(-1)
 
 	return new Intersection(contactPoint, depth, normalA, normalB)
 }
 
-export function intersectCircleVsCircle(a: Circle, b: Circle) {
+export function circleVsCircle(a: Circle, b: Circle) {
 	const dx = b.center.x - a.center.x
 	const dy = b.center.y - a.center.y
 	const distance = Math.sqrt(dx ** 2 + dy ** 2)
@@ -68,7 +68,7 @@ export function intersectCircleVsCircle(a: Circle, b: Circle) {
 		? new Vec2(1, 0) // fallback for perfectly overlapping circles
 		: new Vec2(dx / distance, dy / distance)
 
-	const normalB = normalA.clone().multiplyBy(-1)
+	const normalB = normalA.dup().mulBy(-1)
 
 	const contactPoint = new Vec2(
 		(a.center.x + b.center.x) / 2,

package/s/physics/index.ts

@@ -0,0 +1,4 @@
+
+export * from "./2d/collide2d.barrel.js"
+export * from "./2d/intersect2d.barrel.js"
+

package/s/shapes/2d/circle.ts

@@ -18,11 +18,11 @@ export class Circle {
 	}
 
 	toJSON(): CircleJson {
-		return [this.center.clone().toJSON(), this.radius]
+		return [this.center.dup().toJSON(), this.radius]
 	}
 
 	clone() {
-		return new Circle(this.center.clone(), this.radius)
+		return new Circle(this.center.dup(), this.radius)
 	}
 
 	set(circle: CircleLike) {
@@ -37,7 +37,7 @@ export class Circle {
 
 	boundingBox() {
 		const size = Vec2.all(this.radius * 2)
-		return Rect.fromCenter(this.center.clone(), size)
+		return Rect.fromCenter(this.center.dup(), size)
 	}
 }