@fi4f/hg 0.0.11 → 0.0.12

package/dist/stage.js

@@ -0,0 +1,303 @@
+import { Canvas } from "./canvas.js";
+import { Event } from "./event.js";
+import { Scene } from "./scene.js";
+import { Vector2 } from "./vector2.js";
+/**
+ * A collection of constants and functions for constructing and
+ * interacting with Stage objects.
+ */
+export const Stage = {
+    new(o) {
+        const configureDebug = o?.debug ?? false;
+        const configureW = o?.w ?? 0;
+        const configureH = o?.h ?? 0;
+        const configureLogicalBackground = o?.lbg ?? "#000";
+        const configureVirtualBackground = o?.vbg ?? "#fff";
+        const configureScaleIncrement = o?.si;
+        const configureImageSmoothing = o?.is;
+        const logicalCanvasElement = o?.canvas ?? Canvas.Default();
+        const virtualCanvasElement = new OffscreenCanvas(configureW || logicalCanvasElement.width, configureH || logicalCanvasElement.height);
+        const logicalCanvasContext = logicalCanvasElement.getContext("2d");
+        const virtualCanvasContext = virtualCanvasElement.getContext("2d");
+        // configure image smoothing
+        logicalCanvasContext.imageSmoothingEnabled = !!configureImageSmoothing;
+        virtualCanvasContext.imageSmoothingEnabled = !!configureImageSmoothing;
+        if (configureImageSmoothing) {
+            logicalCanvasContext.imageSmoothingQuality = configureImageSmoothing;
+            virtualCanvasContext.imageSmoothingQuality = configureImageSmoothing;
+        }
+        // configure virtual scale
+        let virtualScale = Math.min(logicalCanvasElement.width / virtualCanvasElement.width, logicalCanvasElement.height / virtualCanvasElement.height);
+        if (configureScaleIncrement)
+            virtualScale = Math.floor(virtualScale / configureScaleIncrement) * configureScaleIncrement;
+        const stage = {
+            // configuration
+            configureDebug,
+            configureW,
+            configureH,
+            configureLogicalBackground,
+            configureVirtualBackground,
+            configureScaleIncrement,
+            configureImageSmoothing,
+            // canvas
+            logicalCanvasElement,
+            virtualCanvasElement,
+            logicalCanvasContext,
+            virtualCanvasContext,
+            virtualScale,
+            // data
+            event: Event.Tree.new(),
+            debug: new Map(),
+            scene: undefined,
+            // metrics
+            measuredFramesPerSecond: 0,
+            measuredAverageFrame: 0,
+            measuredMinimumFrame: 0,
+            measuredMaximumFrame: 0,
+            measuredAverageUpdate: 0,
+            measuredMinimumUpdate: 0,
+            measuredMaximumUpdate: 0,
+            measuredAverageRender: 0,
+            measuredMinimumRender: 0,
+            measuredMaximumRender: 0,
+        };
+        Stage.setDebugInfo(stage, "stage:frameInfo", undefined);
+        Stage.setDebugInfo(stage, "stage:updateInfo", undefined);
+        Stage.setDebugInfo(stage, "stage:renderInfo", undefined);
+        Stage.setDebugInfo(stage, "stage:canvasInfo", undefined);
+        new ResizeObserver(() => resize(stage)).observe(logicalCanvasElement);
+        Stage.listen(stage, "stage:resize", resize => onResize(stage, resize));
+        Stage.listen(stage, "stage:change", change => onChange(stage, change));
+        requestAnimationFrame(firstFrame => requestAnimationFrame(lastFrame => requestAnimationFrame(thisFrame => animate(stage, firstFrame, lastFrame, thisFrame))));
+        return stage;
+    },
+    getLogicalSize(stage) {
+        return Vector2.new(stage.logicalCanvasElement.width, stage.logicalCanvasElement.height);
+    },
+    getVirtualSize(stage) {
+        return Vector2.new(stage.virtualCanvasElement.width, stage.virtualCanvasElement.height);
+    },
+    getVirtualScale(stage) {
+        return stage.virtualScale;
+    },
+    use(stage, scene) {
+        Stage.dispatch(stage, "stage:change", scene);
+    },
+    listen(stage, type, listener, o) {
+        Event.listen(stage.event, type, listener, o);
+    },
+    deafen(stage, type, listener, o) {
+        Event.deafen(stage.event, type, listener, o);
+    },
+    dispatch(stage, type, event, o) {
+        Event.dispatch(stage.event, type, event, o);
+    },
+    poll(stage) {
+        Event.poll(stage.event);
+    },
+    getDebugInfo(stage, id) {
+        return stage.debug.get(id);
+    },
+    setDebugInfo(stage, id, info) {
+        stage.debug.set(id, info);
+    }
+};
+function resize(stage) {
+    const w = stage.logicalCanvasElement.getBoundingClientRect().width;
+    const h = stage.logicalCanvasElement.getBoundingClientRect().height;
+    Stage.dispatch(stage, "stage:resize", [w, h]);
+}
+function onResize(stage, [w, h]) {
+    // compute new canvas sizes
+    stage.logicalCanvasElement.width = w;
+    stage.logicalCanvasElement.height = h;
+    stage.virtualCanvasElement = new OffscreenCanvas(stage.configureW || stage.logicalCanvasElement.width, stage.configureH || stage.logicalCanvasElement.height);
+    // new canvas contexts
+    stage.logicalCanvasContext = stage.logicalCanvasElement.getContext("2d");
+    stage.virtualCanvasContext = stage.virtualCanvasElement.getContext("2d");
+    // configure image smoothing
+    stage.logicalCanvasContext.imageSmoothingEnabled = !!stage.configureImageSmoothing;
+    stage.virtualCanvasContext.imageSmoothingEnabled = !!stage.configureImageSmoothing;
+    if (stage.configureImageSmoothing) {
+        stage.logicalCanvasContext.imageSmoothingQuality = stage.configureImageSmoothing;
+        stage.virtualCanvasContext.imageSmoothingQuality = stage.configureImageSmoothing;
+    }
+    // configure virtual scale
+    stage.virtualScale = Math.min(stage.logicalCanvasElement.width / stage.virtualCanvasElement.width, stage.logicalCanvasElement.height / stage.virtualCanvasElement.height);
+    if (stage.configureScaleIncrement)
+        stage.virtualScale = Math.floor(stage.virtualScale / stage.configureScaleIncrement) * stage.configureScaleIncrement;
+    Stage.setDebugInfo(stage, "stage:canvasInfo", getCanvasInfo(stage));
+}
+function onChange(stage, scene) {
+    if (stage.scene && stage.scene.onDetach)
+        stage.scene.onDetach(stage);
+    stage.scene = scene;
+    if (stage.scene && stage.scene.onAttach)
+        stage.scene.onAttach(stage);
+}
+function update(stage, t, dt) {
+    Stage.poll(stage);
+    if (Scene.doesUpdate(stage.scene))
+        stage.scene.onUpdate({ stage, t, dt });
+}
+function render(stage, t, dt) {
+    const f = stage.logicalCanvasContext;
+    const g = stage.virtualCanvasContext;
+    f.resetTransform();
+    g.resetTransform();
+    f.fillStyle = stage.configureLogicalBackground;
+    const [lw, lh] = Stage.getLogicalSize(stage);
+    f.fillRect(0, 0, lw, lh);
+    g.fillStyle = stage.configureVirtualBackground;
+    const [vw, vh] = Stage.getVirtualSize(stage);
+    g.fillRect(0, 0, vw, vh);
+    const vs = Stage.getVirtualScale(stage);
+    f.translate(lw / 2 - vw * vs / 2, lh / 2 - vh * vs / 2);
+    f.scale(vs, vs);
+    if (Scene.doesRender(stage.scene))
+        stage.scene.onRender({ stage, t, dt, g });
+    f.drawImage(stage.virtualCanvasElement, 0, 0);
+    if (stage.configureDebug && stage.configureDebug !== "print")
+        paintDebugInfo(stage);
+}
+const Timing = {
+    new() {
+        return {
+            framesPerSecondAccumulator: 0,
+            averageFrameAccumulator: 0,
+            minimumFrameAccumulator: Infinity,
+            maximumFrameAccumulator: 0,
+            averageUpdateAccumulator: 0,
+            minimumUpdateAccumulator: Infinity,
+            maximumUpdateAccumulator: 0,
+            averageRenderAccumulator: 0,
+            minimumRenderAccumulator: Infinity,
+            maximumRenderAccumulator: 0,
+            oneSecondAccumulator: 0,
+        };
+    }
+};
+function animate(stage, t0, t1, t2, m) {
+    m ??= Timing.new();
+    const t = (t2 - t0) / 1000;
+    const dt = (t2 - t1) / 1000;
+    const a = performance.now();
+    update(stage, t, dt);
+    const b = performance.now();
+    render(stage, t, dt);
+    const c = performance.now();
+    const deltaFrame = c - a;
+    const deltaUpdate = b - a;
+    const deltaRender = c - b;
+    m.framesPerSecondAccumulator += 1;
+    m.averageFrameAccumulator += deltaFrame;
+    m.minimumFrameAccumulator = Math.min(deltaFrame, m.minimumFrameAccumulator);
+    m.maximumFrameAccumulator = Math.max(deltaFrame, m.maximumFrameAccumulator);
+    m.averageUpdateAccumulator += deltaUpdate;
+    m.minimumUpdateAccumulator = Math.min(deltaUpdate, m.minimumUpdateAccumulator);
+    m.maximumUpdateAccumulator = Math.max(deltaUpdate, m.maximumUpdateAccumulator);
+    m.averageRenderAccumulator += deltaRender;
+    m.minimumRenderAccumulator = Math.min(deltaRender, m.minimumRenderAccumulator);
+    m.maximumRenderAccumulator = Math.max(deltaRender, m.maximumRenderAccumulator);
+    m.oneSecondAccumulator += dt;
+    if (m.oneSecondAccumulator >= 1) {
+        stage.measuredFramesPerSecond = m.framesPerSecondAccumulator;
+        stage.measuredAverageFrame = m.averageFrameAccumulator / m.framesPerSecondAccumulator;
+        stage.measuredMinimumFrame = m.minimumFrameAccumulator;
+        stage.measuredMaximumFrame = m.maximumFrameAccumulator;
+        stage.measuredAverageUpdate = m.averageUpdateAccumulator / m.framesPerSecondAccumulator;
+        stage.measuredMinimumUpdate = m.minimumUpdateAccumulator;
+        stage.measuredMaximumUpdate = m.maximumUpdateAccumulator;
+        stage.measuredAverageRender = m.averageRenderAccumulator / m.framesPerSecondAccumulator;
+        stage.measuredMinimumRender = m.minimumRenderAccumulator;
+        stage.measuredMaximumRender = m.maximumRenderAccumulator;
+        // reset accumulators
+        m.framesPerSecondAccumulator = 0;
+        m.averageFrameAccumulator = 0;
+        m.minimumFrameAccumulator = Infinity;
+        m.maximumFrameAccumulator = 0;
+        m.averageUpdateAccumulator = 0;
+        m.minimumUpdateAccumulator = Infinity;
+        m.maximumUpdateAccumulator = 0;
+        m.averageRenderAccumulator = 0;
+        m.minimumRenderAccumulator = Infinity;
+        m.maximumRenderAccumulator = 0;
+        m.oneSecondAccumulator = 0;
+        Stage.setDebugInfo(stage, "stage:frameInfo", getFrameInfo(stage));
+        Stage.setDebugInfo(stage, "stage:updateInfo", getUpdateInfo(stage));
+        Stage.setDebugInfo(stage, "stage:renderInfo", getRenderInfo(stage));
+        if (stage.configureDebug && stage.configureDebug !== "print")
+            printDebugInfo(stage);
+    }
+    requestAnimationFrame(t3 => animate(stage, t0, t2, t3));
+}
+function getFrameInfo(stage) {
+    return `FRAME ${stage.measuredFramesPerSecond.toFixed(0)} hz @ ${stage.measuredAverageFrame.toFixed(2)} [${stage.measuredMinimumFrame.toFixed(2)} - ${stage.measuredMaximumFrame.toFixed(2)}] ms`;
+}
+function getUpdateInfo(stage) {
+    return `UPDATE ${stage.measuredAverageFrame.toFixed(2)} [${stage.measuredMinimumFrame.toFixed(2)} - ${stage.measuredMaximumFrame.toFixed(2)}] ms`;
+}
+function getRenderInfo(stage) {
+    return `RENDER ${stage.measuredAverageFrame.toFixed(2)} [${stage.measuredMinimumFrame.toFixed(2)} - ${stage.measuredMaximumFrame.toFixed(2)}] ms`;
+}
+function getCanvasInfo(stage) {
+    const [lw, lh] = Stage.getLogicalSize(stage);
+    const [vw, vh] = Stage.getVirtualSize(stage);
+    const vs = Stage.getVirtualScale(stage);
+    return `CANVAS ${lw}x${lh} ${vw}x${vh} ${(100 * vs).toFixed(2)}%`;
+}
+function printDebugInfo(stage) {
+    let infos = "*** DEBUG ***\n";
+    for (const [id, info] of stage.debug) {
+        if (!info)
+            continue;
+        infos += `${info}\n`;
+    }
+    console.log(infos);
+}
+const configureDebugInfoBackground = "#000a";
+const configureDebugInfoForeground = "#ffff";
+const configureDebugInfoPaddingL = 10;
+const configureDebugInfoPaddingR = 10;
+const configureDebugInfoPaddingT = 10;
+const configureDebugInfoPaddingB = 10;
+const configureDebugInfoSpacing = 0;
+const configureDebugInfoFont = "16px monospace";
+function paintDebugInfo(stage) {
+    const g = stage.logicalCanvasContext;
+    g.resetTransform();
+    g.font = configureDebugInfoFont;
+    let w = 0;
+    let h = 0;
+    for (const [id, info] of stage.debug) {
+        if (!info)
+            continue;
+        const tm = g.measureText(info);
+        w = Math.max(w, tm.width);
+        h += (tm.fontBoundingBoxAscent +
+            tm.fontBoundingBoxDescent +
+            configureDebugInfoSpacing);
+    }
+    if (h > 0) {
+        w += configureDebugInfoPaddingL + configureDebugInfoPaddingR;
+        h += configureDebugInfoPaddingT + configureDebugInfoPaddingB;
+        h -= configureDebugInfoSpacing;
+    }
+    // draw background
+    g.fillStyle = configureDebugInfoBackground;
+    g.fillRect(0, 0, w, h);
+    // draw foreground
+    g.fillStyle = configureDebugInfoForeground;
+    let x = configureDebugInfoPaddingL;
+    let y = configureDebugInfoPaddingT;
+    for (const [id, info] of stage.debug) {
+        if (!info)
+            continue;
+        const tm = g.measureText(info);
+        g.fillText(info, x, y + tm.fontBoundingBoxAscent);
+        y += (tm.fontBoundingBoxAscent +
+            tm.fontBoundingBoxDescent +
+            configureDebugInfoSpacing);
+    }
+}
+//# sourceMappingURL=stage.js.map

package/dist/stage.js.map

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

package/dist/vector2.d.ts

@@ -0,0 +1,114 @@
+export type Vector2 = [number, number];
+/**
+ * A collection of constants and functions for constructing and
+ * interacting with Vector2 objects.
+ */
+export declare const Vector2: {
+    /** Constant index for the x-component of a Vector2 */
+    X: 0;
+    /** Constant index for the y-component of a Vector2 */
+    Y: 1;
+    /** A collection of getters for Vector2 objects */
+    Get: {
+        /** Get the x-component of a Vector2 */
+        x(a: Vector2): number;
+        /** Get the y-component of a Vector2 */
+        y(a: Vector2): number;
+    };
+    /** A collection of setters for Vector2 objects */
+    Set: {
+        /** Set the x-component of a Vector2 */
+        x(a: Vector2, x: number): number;
+        /** Set the y-component of a Vector2 */
+        y(a: Vector2, y: number): number;
+    };
+    /** Get or set (when `x` is defined) the x-component of a Vector2 */
+    x(a: Vector2, x?: number): number;
+    /** Get or set (when `y` is defined) the y-component of a Vector2 */
+    y(a: Vector2, y?: number): number;
+    /**
+     * Construct a Vector2 from a variadic array of numbers.
+     *
+     * Constructs a uniform Vector2 when `a.length === 1`
+     * ```js
+     * Vector2.new(1) // [1, 1]
+     * ```
+     * Otherwise constructs a standard zero-padded Vector2
+     * ```js
+     * Vector2.new(    ) // [0, 0]
+     * Vector2.new(1, 2) // [1, 2]
+     * ```
+     */
+    "new"(...a: Array<number>): [number, number];
+    /**
+     * Constructs a Vector2 from a number or an array of numbers.
+     *
+     * Constructs a uniform Vector2 when `a` is a number
+     * ```js
+     * Vector2.from(1) // [1, 1]
+     * ```
+     * Otherwise constructs a standard zero-padded Vector2
+     * ```js
+     * Vector2.from([    ]) // [0, 0]
+     * Vector2.from([1   ]) // [1, 0]
+     * Vector2.from([1, 2]) // [1, 2]
+     * ```
+     */
+    from(a: number | Array<number>): [number, number];
+    /**
+     * Perform an element-wise operation on two Vector2 objects.
+     * Number-like arguments are promoted to uniform Vector2 objects
+     * before performing the operation. Constructs a new Vector2 when an
+     * output argument is not provided.
+     */
+    el(op: (a: number, b: number) => number, a: number | Vector2, b: number | Vector2, out?: Vector2): Vector2;
+    /**
+     * Compute the sum of two Vector2 objects. Number-like arguments are
+     * promoted to uniform Vector2 objects before performing the operation.
+     * Constructs a new Vector2 when an output argument is not provided.
+     */
+    add(a: number | Vector2, b: number | Vector2, out?: Vector2): Vector2;
+    /**
+     * Compute the difference of two Vector2 objects. Number-like arguments
+     * are promoted to uniform Vector2 objects before performing the
+     * operation. Constructs a new Vector2 when an output argument is not
+     * provided.
+     */
+    sub(a: number | Vector2, b: number | Vector2, out?: Vector2): Vector2;
+    /**
+     * Compute the hadamard (element-wise) product of two Vector2 objects.
+     * Number-like arguments are promoted to uniform Vector2 objects before
+     * performing the operation. Constructs a new Vector2 when an output
+     * argument is not provided.
+     */
+    hmul(a: number | Vector2, b: number | Vector2, out?: Vector2): Vector2;
+    /**
+     * Compute the hadamard (element-wise) quotient of two Vector2 objects.
+     * Number-like arguments are promoted to uniform Vector2 objects before
+     * performing the operation. Constructs a new Vector2 when an output
+     * argument is not provided.
+     */
+    hdiv(a: number | Vector2, b: number | Vector2, out?: Vector2): Vector2;
+    /**
+     * Compute the hadamard (element-wise) remainder of two Vector2 objects.
+     * Number-like arguments are promoted to uniform Vector2 objects before
+     * performing the operation. Constructs a new Vector2 when an output
+     * argument is not provided.
+     */
+    hmod(a: number | Vector2, b: number | Vector2, out?: Vector2): Vector2;
+    /**
+     * Compute the dot product of two Vector2 objects, or simply the
+     * dot product of `a` with itself when `b` is not defined. Number-like
+     * arguments are promoted to uniform Vector2 objects before performing
+     * the operation.
+     */
+    dot(a: number | Vector2, b?: number | Vector2): number;
+    /**
+     * Convert a Vector2 into its string representation
+     * ```js
+     * Vector2.toString([1, 2]) // "vec2<1, 2>"
+     * ```
+     */
+    toString([x, y]: Vector2): `vec2<${number}, ${number}>`;
+};
+//# sourceMappingURL=vector2.d.ts.map

package/dist/vector2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector2.d.ts","sourceRoot":"","sources":["../src/vector2.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEtC;;;GAGG;AACH,eAAO,MAAM,OAAO;IAClB,sDAAsD;;IAEtD,sDAAsD;;IAGtD,kDAAkD;;QAEhD,uCAAuC;aAClC,OAAO;QACZ,uCAAuC;aAClC,OAAO;;IAGd,kDAAkD;;QAEhD,uCAAuC;aAClC,OAAO,KAAK,MAAM;QACvB,uCAAuC;aAClC,OAAO,KAAK,MAAM;;IAGzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB;;;;;;;;;;;;OAYG;gBACO,KAAK,CAAC,MAAM,CAAC;IAWvB;;;;;;;;;;;;;OAaG;YACK,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAW9B;;;;;OAKG;WACI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAQ/F;;;;OAIG;WACI,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI1D;;;;;OAKG;WACI,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI1D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;WACI,MAAM,GAAG,OAAO,MAAK,MAAM,GAAG,OAAO;IAM5C;;;;;OAKG;qBACe,OAAO;CAG1B,CAAA"}

package/dist/vector2.js

@@ -0,0 +1,168 @@
+import { add, sub, mul, div, mod } from "./el.js";
+/**
+ * A collection of constants and functions for constructing and
+ * interacting with Vector2 objects.
+ */
+export const Vector2 = {
+    /** Constant index for the x-component of a Vector2 */
+    X: 0,
+    /** Constant index for the y-component of a Vector2 */
+    Y: 1,
+    /** A collection of getters for Vector2 objects */
+    Get: {
+        /** Get the x-component of a Vector2 */
+        x(a) { return a[Vector2.X]; },
+        /** Get the y-component of a Vector2 */
+        y(a) { return a[Vector2.Y]; },
+    },
+    /** A collection of setters for Vector2 objects */
+    Set: {
+        /** Set the x-component of a Vector2 */
+        x(a, x) { return a[Vector2.X] = x; },
+        /** Set the y-component of a Vector2 */
+        y(a, y) { return a[Vector2.Y] = y; },
+    },
+    /** Get or set (when `x` is defined) the x-component of a Vector2 */
+    x(a, x) {
+        if (x === undefined)
+            return Vector2.Get.x(a);
+        else
+            return Vector2.Set.x(a, x);
+    },
+    /** Get or set (when `y` is defined) the y-component of a Vector2 */
+    y(a, y) {
+        if (y === undefined)
+            return Vector2.Get.y(a);
+        else
+            return Vector2.Set.y(a, y);
+    },
+    /**
+     * Construct a Vector2 from a variadic array of numbers.
+     *
+     * Constructs a uniform Vector2 when `a.length === 1`
+     * ```js
+     * Vector2.new(1) // [1, 1]
+     * ```
+     * Otherwise constructs a standard zero-padded Vector2
+     * ```js
+     * Vector2.new(    ) // [0, 0]
+     * Vector2.new(1, 2) // [1, 2]
+     * ```
+     */
+    new(...a) {
+        if (a.length === 1)
+            return [
+                a[Vector2.X],
+                a[Vector2.X]
+            ];
+        else
+            return [
+                a[Vector2.X] ?? 0,
+                a[Vector2.Y] ?? 0
+            ];
+    },
+    /**
+     * Constructs a Vector2 from a number or an array of numbers.
+     *
+     * Constructs a uniform Vector2 when `a` is a number
+     * ```js
+     * Vector2.from(1) // [1, 1]
+     * ```
+     * Otherwise constructs a standard zero-padded Vector2
+     * ```js
+     * Vector2.from([    ]) // [0, 0]
+     * Vector2.from([1   ]) // [1, 0]
+     * Vector2.from([1, 2]) // [1, 2]
+     * ```
+     */
+    from(a) {
+        if (typeof a === "number")
+            return [
+                a,
+                a
+            ];
+        else
+            return [
+                a[Vector2.X] ?? 0,
+                a[Vector2.Y] ?? 0
+            ];
+    },
+    /**
+     * Perform an element-wise operation on two Vector2 objects.
+     * Number-like arguments are promoted to uniform Vector2 objects
+     * before performing the operation. Constructs a new Vector2 when an
+     * output argument is not provided.
+     */
+    el(op, a, b, out = Vector2.new()) {
+        const [xa, ya] = Vector2.from(a);
+        const [xb, yb] = Vector2.from(b);
+        Vector2.Set.x(out, op(xa, xb));
+        Vector2.Set.y(out, op(ya, yb));
+        return out;
+    },
+    /**
+     * Compute the sum of two Vector2 objects. Number-like arguments are
+     * promoted to uniform Vector2 objects before performing the operation.
+     * Constructs a new Vector2 when an output argument is not provided.
+     */
+    add(a, b, out = Vector2.new()) {
+        return Vector2.el(add, a, b, out);
+    },
+    /**
+     * Compute the difference of two Vector2 objects. Number-like arguments
+     * are promoted to uniform Vector2 objects before performing the
+     * operation. Constructs a new Vector2 when an output argument is not
+     * provided.
+     */
+    sub(a, b, out = Vector2.new()) {
+        return Vector2.el(sub, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) product of two Vector2 objects.
+     * Number-like arguments are promoted to uniform Vector2 objects before
+     * performing the operation. Constructs a new Vector2 when an output
+     * argument is not provided.
+     */
+    hmul(a, b, out = Vector2.new()) {
+        return Vector2.el(mul, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) quotient of two Vector2 objects.
+     * Number-like arguments are promoted to uniform Vector2 objects before
+     * performing the operation. Constructs a new Vector2 when an output
+     * argument is not provided.
+     */
+    hdiv(a, b, out = Vector2.new()) {
+        return Vector2.el(div, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) remainder of two Vector2 objects.
+     * Number-like arguments are promoted to uniform Vector2 objects before
+     * performing the operation. Constructs a new Vector2 when an output
+     * argument is not provided.
+     */
+    hmod(a, b, out = Vector2.new()) {
+        return Vector2.el(mod, a, b, out);
+    },
+    /**
+     * Compute the dot product of two Vector2 objects, or simply the
+     * dot product of `a` with itself when `b` is not defined. Number-like
+     * arguments are promoted to uniform Vector2 objects before performing
+     * the operation.
+     */
+    dot(a, b = a) {
+        const [xa, ya] = Vector2.from(a);
+        const [xb, yb] = Vector2.from(b);
+        return xa * xb + ya * yb;
+    },
+    /**
+     * Convert a Vector2 into its string representation
+     * ```js
+     * Vector2.toString([1, 2]) // "vec2<1, 2>"
+     * ```
+     */
+    toString([x, y]) {
+        return `vec2<${x}, ${y}>`;
+    }
+};
+//# sourceMappingURL=vector2.js.map

package/dist/vector2.js.map

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