wtc-math 1.3.0

A math library for JavaScript and TypeScript — vectors, matrices, quaternions, and utilities for 3D graphics and creative coding.

Install

npm install wtc-math

Usage

The core classes are available from the main entry point:

import { Vec2, Vec3, Vec4, Mat2, Mat3, Mat4, Quat } from "wtc-math";
import { clamp, lerp, map, smoothstep, degToRad } from "wtc-math";

Color, Plane, and Ray are optional — import them only when needed:

import { Color } from "wtc-math/color";
import { Plane } from "wtc-math/plane";
import { Ray }   from "wtc-math/ray";

Classes

Class	Description
Vec2	2D vector
Vec3	3D vector
Vec4	4D vector
Mat2	2×2 matrix
Mat3	3×3 matrix
Mat4	4×4 matrix
Quat	Quaternion (extends Vec4)
Color	RGBA colour in 0–1 space — fromHex, fromHSL, lerp, toCSS
Plane	Plane in 3D — distanceTo, projectPoint, intersectLine
Ray	Ray in 3D — at, intersectSphere, intersectBox, intersectPlane

Utilities

clamp(v, min, max)
lerp(a, b, t)
map(v, inMin, inMax, outMin, outMax)
smoothstep(edge0, edge1, x)
smootherstep(edge0, edge1, x)
degToRad(deg)
radToDeg(rad)
pingpong(t, length)

Types

All structural types are exported:

import type { Vec2Like, Vec3Like, Vec4Like, QuatLike, Mat2Like, Mat3Like, Mat4Like } from "wtc-math";

Documentation

Full API docs: wethegit.github.io/wtc-math