@benev/math 0.2.0 → 0.3.0-2

package/x/utils/scalar.d.ts

@@ -0,0 +1,51 @@
+export declare class Scalar {
+    x: number;
+    constructor(x: number);
+    static new(x: number): Scalar;
+    clone(): Scalar;
+    set(x: number): this;
+    static isBetween(x: number, a?: number, b?: number): boolean;
+    isBetween(a?: number, b?: number): boolean;
+    static isNear(x: number, y: number, epsilon?: number): boolean;
+    isNear(y: number, epsilon?: number): boolean;
+    static add(...nums: number[]): number;
+    add(...nums: number[]): this;
+    subtract(...nums: number[]): this;
+    static min(x: number, minimum?: number): number;
+    min(minimum?: number): this;
+    static max(x: number, maximum?: number): number;
+    max(maximum?: number): this;
+    static clamp(x: number, a?: number, b?: number): number;
+    clamp(a?: number, b?: number): this;
+    static lerp(x: number, y: number, fraction: number, max?: number): number;
+    lerp(y: number, fraction: number, max?: number): this;
+    static step(x: number, y: number, delta: number): number;
+    step(y: number, delta: number): this;
+    static creep(difference: number, speed: number, deltaTime: number, speedLimit?: number): number;
+    static approach(x: number, y: number, speed: number, deltaTime: number, speedLimit?: number): number;
+    approach(y: number, speed: number, deltaTime: number, speedLimit?: number): this;
+    static wrap(x: number, a?: number, b?: number): number;
+    wrap(a?: number, b?: number): this;
+    static constrainProximity(x: number, y: number, range: number): number;
+    constrainProximity(y: number, range: number): this;
+    static inverse(x: number): number;
+    inverse(): this;
+    static center(x: number): number;
+    center(): this;
+    static uncenter(x: number): number;
+    uncenter(): this;
+    static map(x: number, a: number, b: number): number;
+    map(a: number, b: number): this;
+    static remap(x: number, a1: number, a2: number, b1?: number, b2?: number, clamp?: boolean): number;
+    remap(a1: number, a2: number, b1?: number, b2?: number, clamp?: boolean): this;
+    static magnify(x: number): number;
+    magnify(): this;
+    static floor(x: number): number;
+    floor(): this;
+    static ceil(x: number): number;
+    ceil(): this;
+    static round(x: number): number;
+    round(): this;
+    static smooth(x: number, y: number, smoothing: number): number;
+    smooth(y: number, smoothing: number): this;
+}

package/x/utils/scalar.js

@@ -0,0 +1,219 @@
+export class Scalar {
+    x;
+    constructor(x) {
+        this.x = x;
+    }
+    static new(x) {
+        return new this(x);
+    }
+    clone() {
+        return new Scalar(this.x);
+    }
+    set(x) {
+        this.x = x;
+        return this;
+    }
+    //
+    // queries
+    //
+    static isBetween(x, a = 0, b = 1) {
+        const min = Math.min(a, b);
+        const max = Math.max(a, b);
+        return (x >= min) && (x <= max);
+    }
+    isBetween(a = 0, b = 1) {
+        return Scalar.isBetween(this.x, a, b);
+    }
+    static isNear(x, y, epsilon = 0.01) {
+        return Math.abs(x - y) <= epsilon;
+    }
+    isNear(y, epsilon = 0.01) {
+        return Scalar.isNear(this.x, y, epsilon);
+    }
+    //
+    // chainable transforms
+    //
+    static add(...nums) {
+        let x = 0;
+        for (const n of nums)
+            x += n;
+        return x;
+    }
+    add(...nums) {
+        this.x = Scalar.add(...nums);
+        return this;
+    }
+    subtract(...nums) {
+        for (const n of nums)
+            this.x -= n;
+        return this;
+    }
+    static min(x, minimum = 0) {
+        return Math.max(x, minimum);
+    }
+    min(minimum = 0) {
+        this.x = Scalar.min(this.x, minimum);
+        return this;
+    }
+    static max(x, maximum = 1) {
+        return Math.min(x, maximum);
+    }
+    max(maximum = 1) {
+        this.x = Scalar.max(this.x, maximum);
+        return this;
+    }
+    static clamp(x, a = 0, b = 1) {
+        x = Scalar.min(x, Math.min(a, b));
+        x = Scalar.max(x, Math.max(a, b));
+        return x;
+    }
+    clamp(a = 0, b = 1) {
+        this.x = Scalar.clamp(this.x, a, b);
+        return this;
+    }
+    static lerp(x, y, fraction, max) {
+        const difference = y - x;
+        let delta = difference * fraction;
+        if (max !== undefined && Math.abs(delta) > max)
+            delta = Math.sign(delta) * max;
+        return x + delta;
+    }
+    lerp(y, fraction, max) {
+        this.x = Scalar.lerp(this.x, y, fraction, max);
+        return this;
+    }
+    static step(x, y, delta) {
+        const difference = y - x;
+        return (Math.abs(difference) <= delta)
+            ? y
+            : x + (Math.sign(difference) * delta);
+    }
+    step(y, delta) {
+        this.x = Scalar.step(this.x, y, delta);
+        return this;
+    }
+    static creep(difference, speed, deltaTime, speedLimit) {
+        let change = (difference * (1 - Math.exp(-speed * deltaTime)));
+        if (speedLimit !== undefined) {
+            const changeLimit = speedLimit * deltaTime;
+            if (Math.abs(change) > changeLimit)
+                change = Math.sign(change) * changeLimit;
+        }
+        return change;
+    }
+    static approach(x, y, speed, deltaTime, speedLimit) {
+        const difference = y - x;
+        const change = this.creep(difference, speed, deltaTime, speedLimit);
+        return x + change;
+    }
+    approach(y, speed, deltaTime, speedLimit) {
+        this.x = Scalar.approach(this.x, y, speed, deltaTime, speedLimit);
+        return this;
+    }
+    static wrap(x, a = 0, b = 1) {
+        const min = Math.min(a, b);
+        const max = Math.max(a, b);
+        const span = max - min;
+        const adjusted = x - min;
+        const wrapped = (adjusted < 0)
+            ? span - (-adjusted % span)
+            : adjusted % span;
+        return min + wrapped;
+    }
+    wrap(a = 0, b = 1) {
+        this.x = Scalar.wrap(this.x, a, b);
+        return this;
+    }
+    static constrainProximity(x, y, range) {
+        const trueDiff = y - x;
+        const positiveDiff = Math.abs(trueDiff);
+        const cappedDiff = (positiveDiff > range)
+            ? range
+            : positiveDiff;
+        const newDiff = (trueDiff < 0) ? -cappedDiff : cappedDiff;
+        return x + newDiff;
+    }
+    constrainProximity(y, range) {
+        this.x = Scalar.constrainProximity(this.x, y, range);
+        return this;
+    }
+    static inverse(x) {
+        return 1 - x;
+    }
+    inverse() {
+        this.x = Scalar.inverse(this.x);
+        return this;
+    }
+    static center(x) {
+        return (x * 2) - 1;
+    }
+    center() {
+        this.x = Scalar.center(this.x);
+        return this;
+    }
+    static uncenter(x) {
+        return (x + 1) / 2;
+    }
+    uncenter() {
+        this.x = Scalar.uncenter(this.x);
+        return this;
+    }
+    static map(x, a, b) {
+        const difference = b - a;
+        const value = difference * x;
+        return a + value;
+    }
+    map(a, b) {
+        this.x = Scalar.map(this.x, a, b);
+        return this;
+    }
+    static remap(x, a1, a2, b1 = 0, b2 = 1, clamp = false) {
+        const fraction = (x - a1) / (a2 - a1);
+        const result = (fraction * (b2 - b1)) + b1;
+        return clamp
+            ? Scalar.clamp(result, b1, b2)
+            : result;
+    }
+    remap(a1, a2, b1 = 0, b2 = 1, clamp = false) {
+        this.x = Scalar.remap(this.x, a1, a2, b1, b2, clamp);
+        return this;
+    }
+    static magnify(x) {
+        return 4 * Math.pow(x - 0.5, 3) + 0.5;
+    }
+    magnify() {
+        this.x = Scalar.magnify(this.x);
+        return this;
+    }
+    static floor(x) {
+        return Math.floor(x);
+    }
+    floor() {
+        this.x = Scalar.floor(this.x);
+        return this;
+    }
+    static ceil(x) {
+        return Math.ceil(x);
+    }
+    ceil() {
+        this.x = Scalar.ceil(this.x);
+        return this;
+    }
+    static round(x) {
+        return Math.round(x);
+    }
+    round() {
+        this.x = Scalar.round(this.x);
+        return this;
+    }
+    static smooth(x, y, smoothing) {
+        return smoothing <= 1
+            ? y
+            : x + ((y - x) / smoothing);
+    }
+    smooth(y, smoothing) {
+        this.x = Scalar.smooth(this.x, y, smoothing);
+        return this;
+    }
+}
+//# sourceMappingURL=scalar.js.map

package/x/utils/scalar.js.map

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

package/x/utils/spline.d.ts

@@ -0,0 +1,9 @@
+import { Vec2Array } from "../core/vec2.js";
+/** resolve a number within a linear spline. */
+export declare function linear(x: number, points: Vec2Array[]): number;
+/** resolve a number within a catmull-rom spline, that's all smooth-like. */
+export declare function catmullRom(x: number, points: Vec2Array[]): number;
+export declare const ez: {
+    /** simple linear spline where the control points are equally-spaced based on their array indices (x is expected to be between 0 and 1). */
+    linear(x: number, points: number[]): number;
+};

package/x/utils/spline.js

@@ -0,0 +1,61 @@
+import { Scalar } from "./scalar.js";
+/** resolve a number within a linear spline. */
+export function linear(x, points) {
+    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++) {
+        const [x0, y0] = points[i];
+        const [x1, y1] = points[i + 1];
+        if (x >= x0 && x <= x1) {
+            const t = (x - x0) / (x1 - x0);
+            return y0 + t * (y1 - y0);
+        }
+    }
+    throw new Error("x is out of bounds, what are you even doing");
+}
+/** resolve a number within a catmull-rom spline, that's all smooth-like. */
+export function catmullRom(x, points) {
+    if (points.length < 4)
+        throw new Error("need at least four points for this magic");
+    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++) {
+        const [x1,] = points[i];
+        const [x2,] = points[i + 1];
+        if (x >= x1 && x <= x2) {
+            const t = (x - x1) / (x2 - x1);
+            return helpers.catmullRom(t, points[i - 1], points[i], points[i + 1], points[i + 2]);
+        }
+    }
+    throw new Error("x is out of bounds, try again");
+}
+export const ez = {
+    /** simple linear spline where the control points are equally-spaced based on their array indices (x is expected to be between 0 and 1). */
+    linear(x, points) {
+        if (points.length < 2)
+            throw new Error("need at least two points, come on");
+        const points2 = points.map((p, index) => [Scalar.clamp(index / (points.length - 1)), p]);
+        return linear(Scalar.clamp(x), points2);
+    }
+};
+var helpers;
+(function (helpers) {
+    /** internal big-brain maths for the catmull-rom implementation */
+    function catmullRom(t, [, p0], [, p1], [, p2], [, p3]) {
+        const t2 = t * t;
+        const t3 = t2 * t;
+        // coefficients for the cubic polynomial (Catmull-Rom)
+        const a = -0.5 * p0 + 1.5 * p1 - 1.5 * p2 + 0.5 * p3;
+        const b = p0 - 2.5 * p1 + 2 * p2 - 0.5 * p3;
+        const c = -0.5 * p0 + 0.5 * p2;
+        const d = p1;
+        return a * t3 + b * t2 + c * t + d;
+    }
+    helpers.catmullRom = catmullRom;
+})(helpers || (helpers = {}));
+//# sourceMappingURL=spline.js.map

package/x/utils/spline.js.map

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