feat: add perspective function to mat4, fix: make Vec3 visible to user

src/app/app.ts

@@ -21,7 +21,7 @@ import type {
 import { type KEventController, KEventHandler } from "../events/events";
 import { canvasToViewport } from "../gfx/viewport";
 import { map, vec2 } from "../math/math";
-import { Vec2 } from "../math/Vec2";
+import { Vec2 } from "../math/vec2";
 import { _k } from "../shared";
 import { deprecateMsg } from "../utils/log";
 import { overload2 } from "../utils/overload";

src/assets/shader.ts

@@ -7,9 +7,9 @@ import {
 } from "../constants/general";
 import { type GfxCtx, Texture } from "../gfx/gfx";
 import { Color } from "../math/color";
-import { Mat4 } from "../math/Mat4";
+import { Mat4 } from "../math/mat4";
 import { Mat23 } from "../math/math";
-import { Vec2 } from "../math/Vec2";
+import { Vec2 } from "../math/vec2";
 import { _k } from "../shared";
 import type { RenderProps } from "../types";
 import { arrayIsColor, arrayIsNumber, arrayIsVec2 } from "../utils/asserts";

src/constants/math.ts

@@ -1,5 +1,5 @@
-import { Mat4 } from "../math/Mat4";
-import { Vec2 } from "../math/Vec2";
+import { Mat4 } from "../math/mat4";
+import { Vec2 } from "../math/vec2";
 
 export const IDENTITY_MATRIX = new Mat4();
 export const TOP_LEFT = new Vec2(-1, -1);

src/core/context.ts

@@ -165,7 +165,7 @@ import { easings } from "../math/easings";
 import { gjkShapeIntersection, gjkShapeIntersects } from "../math/gjk";
 import { lerp } from "../math/lerp";
 import { lerpAngle } from "../math/lerpAngle";
-import { Mat4 } from "../math/Mat4";
+import { Mat4 } from "../math/mat4";
 import {
     bezier,
     cardinal,
@@ -221,6 +221,7 @@ import {
     testRectRect,
     triangulate,
     vec2,
+    vec3,
     wave,
 } from "../math/math";
 import { buildConnectivityMap, floodFill } from "../math/navigation";
@@ -234,7 +235,8 @@ import {
 import { chance, rand, randi, randSeed, RNG, setRNG } from "../math/random";
 import { insertionSort } from "../math/sort";
 import { makeQuadtree, Quadtree } from "../math/spatial/quadtree";
-import { Vec2 } from "../math/Vec2";
+import { Vec2 } from "../math/vec2";
+import { Vec3 } from "../math/vec3";
 import { BlendMode, type KAPLAYPlugin } from "../types";
 import {
     download,
@@ -512,6 +514,7 @@ export const createContext = (
         Polygon,
         Collision,
         Vec2,
+        Vec3,
         Color,
         Mat2,
         Mat4,

src/core/contextType.ts

@@ -147,7 +147,7 @@ import type { Color, CSSColorKeywords } from "../math/color";
 import type { EaseFunc, EaseFuncs } from "../math/easings";
 import type { GjkCollisionResult } from "../math/gjk";
 import type { LerpValue } from "../math/lerp";
-import type { Mat4 } from "../math/Mat4";
+import type { Mat4 } from "../math/mat4";
 import type {
     Circle,
     Ellipse,
@@ -166,7 +166,8 @@ import type { NavGrid } from "../math/navigationgrid";
 import type { NavMesh } from "../math/navigationmesh";
 import type { RandomGenerator, RNG, RNGConfig, RNGSeed } from "../math/random";
 import type { Quadtree, ResizingQuadtree } from "../math/spatial/quadtree";
-import type { Vec2 } from "../math/Vec2";
+import type { Vec2 } from "../math/vec2";
+import type { Vec3 } from "../math/vec3";
 import {
     type Anchor,
     type BlendMode,
@@ -6528,6 +6529,14 @@ export interface KAPLAYCtx {
     Vec2: typeof Vec2;
     /**
      * A color.
+    *
+    * @since v2000.0
+    * @group Math
+    * @subgroup Vectors
+    */
+    Vec3: typeof Vec3;
+    /**
+     * A 3D vector.
      *
      * @since v2000.0
      * @group Math

src/core/frameRendering.ts

@@ -7,7 +7,7 @@ import { drawUVQuad } from "../gfx/draw/drawUVQuad";
 import type { AppGfxCtx } from "../gfx/gfxApp";
 import { flush, height, width } from "../gfx/stack";
 import { Quad } from "../math/math";
-import { Vec2 } from "../math/Vec2";
+import { Vec2 } from "../math/vec2";
 
 /**
  * A frame renderer.

src/ecs/components/draw/circle.ts

@@ -1,7 +1,7 @@
 import { getRenderProps } from "../../../game/utils";
 import { drawCircle } from "../../../gfx/draw/drawCircle";
 import { Circle, Rect } from "../../../math/math";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import type { Comp, GameObj } from "../../../types";
 import { nextRenderAreaVersion } from "../physics/area";
 import type { AnchorComp } from "../transform/anchor";

src/ecs/components/draw/ellipse.ts

@@ -1,7 +1,7 @@
 import { getRenderProps } from "../../../game/utils";
 import { drawEllipse } from "../../../gfx/draw/drawEllipse";
 import { Ellipse } from "../../../math/math";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import type { Comp, GameObj } from "../../../types";
 import { nextRenderAreaVersion } from "../physics/area";
 import type { AnchorComp } from "../transform/anchor";

src/ecs/components/draw/particles.ts

@@ -5,7 +5,7 @@ import { Color } from "../../../math/color";
 import { lerp } from "../../../math/lerp";
 import { deg2rad, map, Quad, type ShapeType, vec2 } from "../../../math/math";
 import { rand } from "../../../math/random";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp } from "../../../types";
 

src/ecs/components/draw/polygon.ts

@@ -6,7 +6,7 @@ import {
 import type { Texture } from "../../../gfx/gfx";
 import type { Color } from "../../../math/color";
 import { Polygon } from "../../../math/math";
-import { type Vec2 } from "../../../math/Vec2";
+import { type Vec2 } from "../../../math/vec2";
 import type { Comp, GameObj } from "../../../types";
 import { nextRenderAreaVersion } from "../physics/area";
 import type { FillComp } from "./fill";

src/ecs/components/draw/raycast.ts

@@ -1,5 +1,5 @@
 import type { RaycastResult } from "../../../math/math";
-import type { Vec2 } from "../../../math/Vec2";
+import type { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 
 // this is not a component lol

src/ecs/components/draw/sprite.ts

@@ -13,7 +13,7 @@ import { anchorPt } from "../../../gfx/anchor";
 import { drawTexture } from "../../../gfx/draw/drawTexture";
 import type { Texture } from "../../../gfx/gfx";
 import { Quad, quad, Rect, vec2 } from "../../../math/math";
-import { type Vec2 } from "../../../math/Vec2";
+import { type Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp, GameObj, SpriteAnimPlayOpt } from "../../../types";
 import { warn } from "../../../utils/log";

src/ecs/components/level/agent.ts

@@ -1,5 +1,5 @@
 import type { KEventController } from "../../../events/events";
-import type { Vec2 } from "../../../math/Vec2";
+import type { Vec2 } from "../../../math/vec2";
 import type { Comp, GameObj } from "../../../types";
 import type { PosComp } from "../transform/pos";
 import type { TileComp } from "./tile";

src/ecs/components/level/level.ts

@@ -6,7 +6,7 @@ import {
     type Vec2Args,
 } from "../../../math/math";
 import { calcTransform } from "../../../math/various";
-import { type Vec2 } from "../../../math/Vec2";
+import { type Vec2 } from "../../../math/vec2";
 import {
     type Comp,
     type CompList,

src/ecs/components/level/pathfinder.ts

@@ -1,5 +1,5 @@
 import { type Graph } from "../../../math/navigation";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import type { Comp, GameObj } from "../../../types";
 import type { PosComp } from "../transform/pos";
 

src/ecs/components/level/patrol.ts

@@ -1,5 +1,5 @@
 import type { KEventController } from "../../../events/events";
-import type { Vec2 } from "../../../math/Vec2";
+import type { Vec2 } from "../../../math/vec2";
 import type { Comp, GameObj } from "../../../types";
 import type { PosComp } from "../transform/pos";
 

src/ecs/components/level/sentry.ts

@@ -1,5 +1,5 @@
 import type { KEventController } from "../../../events/events";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp, GameObj, QueryOpt } from "../../../types";
 import { raycast } from "../draw/raycast";

src/ecs/components/level/tile.ts

@@ -1,5 +1,5 @@
 import { vec2 } from "../../../math/math";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import { type Comp, type Edge, EdgeMask, type GameObj } from "../../../types";
 import type { LevelComp } from "./level";
 

src/ecs/components/misc/animate.ts

@@ -4,7 +4,7 @@ import { Color } from "../../../math/color";
 import { type EaseFunc, easings } from "../../../math/easings";
 import { lerp, type LerpValue } from "../../../math/lerp";
 import { catmullRom, hermiteFirstDerivative, vec2 } from "../../../math/math";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp, GameObj } from "../../../types";
 import type { NamedComp } from "./named";

src/ecs/components/misc/fakeMouse.ts

@@ -1,4 +1,4 @@
-import type { Vec2 } from "../../../math/Vec2";
+import type { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp, GameObj } from "../../../types";
 import type { PosComp } from "../transform/pos";

src/ecs/components/misc/timer.ts

@@ -1,7 +1,7 @@
 import { KEvent } from "../../../events/events";
 import { easings } from "../../../math/easings";
 import { lerp, type LerpValue } from "../../../math/lerp";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp, GameObj } from "../../../types";
 

src/ecs/components/physics/area.ts

@@ -8,7 +8,7 @@ import { drawRect } from "../../../gfx/draw/drawRect";
 import { multTranslate, popTransform, pushTransform } from "../../../gfx/stack";
 import { rgb } from "../../../math/color";
 import { Circle, Polygon, Rect, shapeFactory, vec2 } from "../../../math/math";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type {
     Comp,

src/ecs/components/physics/body.ts

@@ -4,7 +4,7 @@ import { getGravityDirection } from "../../../game/gravity";
 import { lerp } from "../../../math/lerp";
 import { vec2 } from "../../../math/math";
 import { calcTransform } from "../../../math/various";
-import { type Vec2 } from "../../../math/Vec2";
+import { type Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp, GameObj } from "../../../types";
 import { exists } from "../../entity/utils";

src/ecs/components/physics/effectors.ts

@@ -1,5 +1,5 @@
 import { Polygon, vec2 } from "../../../math/math";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import type { Comp, GameObj } from "../../../types";
 import type { PosComp } from "../transform/pos";
 import type { AreaComp } from "./area";

src/ecs/components/transform/anchor.ts

@@ -1,6 +1,6 @@
 import { anchorPt } from "../../../gfx/anchor";
 import { vec2 } from "../../../math/math";
-import { type SerializedVec2, Vec2 } from "../../../math/Vec2";
+import { type SerializedVec2, Vec2 } from "../../../math/vec2";
 import type { Anchor, Comp } from "../../../types";
 
 /**

src/ecs/components/transform/constraint.ts

@@ -18,7 +18,7 @@ import {
     updateChildrenTransformRecursive,
     updateTransformRecursive,
 } from "../../../math/various";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp, GameObj } from "../../../types";
 import { system, SystemPhase } from "../../systems/systems";

src/ecs/components/transform/follow.ts

@@ -1,5 +1,5 @@
 import { vec2 } from "../../../math/math";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import type { Comp, GameObj } from "../../../types";
 import { exists } from "../../entity/utils";
 import type { PosComp } from "./pos";

src/ecs/components/transform/move.ts

@@ -1,4 +1,4 @@
-import { type SerializedVec2, Vec2 } from "../../../math/Vec2";
+import { type SerializedVec2, Vec2 } from "../../../math/vec2";
 import type { Comp, EmptyComp, GameObj } from "../../../types";
 import type { PosComp } from "./pos";
 

src/ecs/components/transform/pos.ts

@@ -2,7 +2,7 @@ import { toScreen, toWorld } from "../../../game/camera";
 import { drawCircle } from "../../../gfx/draw/drawCircle";
 import { rgb } from "../../../math/color";
 import { vec2, type Vec2Args } from "../../../math/math";
-import { Vec2 } from "../../../math/Vec2";
+import { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { Comp, GameObj } from "../../../types";
 import {

src/ecs/components/transform/scale.ts

@@ -1,5 +1,5 @@
 import { vec2, type Vec2Args } from "../../../math/math";
-import { type SerializedVec2, Vec2 } from "../../../math/Vec2";
+import { type SerializedVec2, Vec2 } from "../../../math/vec2";
 import type { Comp } from "../../../types";
 import {
     type InternalGameObjRaw,

src/ecs/components/transform/skew.ts

@@ -1,5 +1,5 @@
 import { vec2, type Vec2Args } from "../../../math/math";
-import { type SerializedVec2, Vec2 } from "../../../math/Vec2";
+import { type SerializedVec2, Vec2 } from "../../../math/vec2";
 import type { Comp } from "../../../types";
 import {
     type InternalGameObjRaw,

src/ecs/entity/premade/addKaboom.ts

@@ -1,4 +1,4 @@
-import type { Vec2 } from "../../../math/Vec2";
+import type { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { CompList, GameObj } from "../../../types";
 import { sprite } from "../../components/draw/sprite";

src/ecs/entity/premade/addLevel.ts

@@ -1,5 +1,5 @@
 import { vec2 } from "../../../math/math";
-import type { Vec2 } from "../../../math/Vec2";
+import type { Vec2 } from "../../../math/vec2";
 import { _k } from "../../../shared";
 import type { GameObj } from "../../../types";
 import {

src/ecs/systems/Collision.ts

@@ -1,5 +1,5 @@
 import { vec2 } from "../../math/math";
-import type { Vec2 } from "../../math/Vec2";
+import type { Vec2 } from "../../math/vec2";
 import { _k } from "../../shared";
 import type { GameObj } from "../../types";
 

src/events/eventMap.ts

@@ -11,7 +11,7 @@ import { type doubleJump } from "../ecs/components/physics/doubleJump";
 import { type offscreen } from "../ecs/components/transform/offscreen";
 import { type addLevel } from "../ecs/entity/premade/addLevel";
 import type { Collision } from "../ecs/systems/Collision";
-import type { Vec2 } from "../math/Vec2";
+import type { Vec2 } from "../math/vec2";
 import type {
     GameObj,
     Key,

src/game/camera.ts

@@ -6,7 +6,7 @@ import { destroy } from "../ecs/entity/utils";
 import { center, height, width } from "../gfx/stack";
 import { type Color, rgb } from "../math/color";
 import { type Mat23, vec2, type Vec2Args } from "../math/math";
-import { Vec2 } from "../math/Vec2";
+import { Vec2 } from "../math/vec2";
 import { _k } from "../shared";
 import { deprecateMsg } from "../utils/log";
 

src/game/game.ts

@@ -17,7 +17,7 @@ import type { GameEventMap, GameObjEventMap } from "../events/eventMap";
 import { type KEventController, KEventHandler } from "../events/events";
 import { Mat23, Rect } from "../math/math";
 import { RNG, type RNGConfig } from "../math/random";
-import { Vec2 } from "../math/Vec2";
+import { Vec2 } from "../math/vec2";
 import type { GameObj } from "../types";
 import type { SceneDef, SceneState } from "./scenes";
 

src/game/gravity.ts

@@ -1,7 +1,7 @@
 // Gravity manipulation
 
 import { vec2 } from "../math/math";
-import { type Vec2 } from "../math/Vec2";
+import { type Vec2 } from "../math/vec2";
 import { _k } from "../shared";
 
 export function setGravity(g: number) {

src/gfx/TexPacker.ts

@@ -1,6 +1,6 @@
 import { drawImageSourceAt } from "../assets/utils";
 import { Quad, Rect, testRectRect } from "../math/math";
-import { Vec2 } from "../math/Vec2";
+import { Vec2 } from "../math/vec2";
 import type { ImageSource, TexFilter } from "../types";
 import { type GfxCtx, Texture } from "./gfx";
 

src/gfx/anchor.ts

@@ -9,7 +9,7 @@ import {
     TOP_LEFT,
     TOP_RIGHT,
 } from "../constants/math";
-import { Vec2 } from "../math/Vec2";
+import { Vec2 } from "../math/vec2";
 import { type Anchor } from "../types";
 import type { TextAlign } from "./draw/drawText";
 

src/gfx/draw/drawBezier.ts

@@ -1,5 +1,5 @@
 import { evaluateBezier } from "../../math/math";
-import { type Vec2 } from "../../math/Vec2";
+import { type Vec2 } from "../../math/vec2";
 import { drawCurve, type DrawCurveOpt } from "./drawCurve";
 
 /**

src/gfx/draw/drawCircle.ts

@@ -1,5 +1,5 @@
 import type { Color } from "../../math/color";
-import type { Vec2 } from "../../math/Vec2";
+import type { Vec2 } from "../../math/vec2";
 import type { Anchor, RenderProps } from "../../types";
 import { drawEllipse } from "./drawEllipse";
 

src/gfx/draw/drawCurve.ts

@@ -1,4 +1,4 @@
-import type { Vec2 } from "../../math/Vec2";
+import type { Vec2 } from "../../math/vec2";
 import type { RenderProps } from "../../types";
 import { drawLines } from "./drawLine";