@oliversalzburg/js-utils 0.7.0 → 0.7.1

package/lib/graphics/palette.test.js

@@ -0,0 +1,43 @@
+import assert from "node:assert";
+import { it } from "node:test";
+import { hslPalette, hsvPalette } from "./palette.js";
+const render = (_) => _.map((x) => x.toString(16).padStart(2, "0")).join("");
+it("renders the correct HSL palettes - Size 1", () => {
+    assert.deepStrictEqual(hslPalette(1).map(render), ["ff0000"], "Default case");
+    // Under-saturated
+    assert.deepStrictEqual(hslPalette(1, 0, 0.25, 0.5).map(render), ["9f5f5f"], "Under-saturated 0.25");
+    assert.deepStrictEqual(hslPalette(1, 0, 0.5, 0.5).map(render), ["bf3f3f"], "Under-saturated 0.5");
+    assert.deepStrictEqual(hslPalette(1, 0, 0.75, 0.5).map(render), ["df1f1f"], "Under-saturated 0.75");
+    // Darker
+    assert.deepStrictEqual(hslPalette(1, 0, 0.25, 0.25).map(render), ["4f2f2f"], "Darker 0.25 0.25");
+    assert.deepStrictEqual(hslPalette(1, 0, 0.5, 0.25).map(render), ["5f1f1f"], "Darker 0.5 0.25");
+    assert.deepStrictEqual(hslPalette(1, 0, 0.75, 0.25).map(render), ["6f0f0f"], "Darker 0.75 0.25");
+    assert.deepStrictEqual(hslPalette(1, 0, 1, 0.25).map(render), ["7f0000"], "Darker 1 0.25");
+    // Lighter
+    assert.deepStrictEqual(hslPalette(1, 0, 0.25, 0.75).map(render), ["cfafaf"], "Lighter 0.25 0.75");
+    assert.deepStrictEqual(hslPalette(1, 0, 0.5, 0.75).map(render), ["df9f9f"], "Lighter 0.5 0.75");
+    assert.deepStrictEqual(hslPalette(1, 0, 0.75, 0.75).map(render), ["ef8f8f"], "Lighter 0.75 0.75");
+    assert.deepStrictEqual(hslPalette(1, 0, 1, 0.75).map(render), ["ff7f7f"], "Lighter 1 0.75");
+});
+it("renders the correct HSL palette - 2", () => {
+    assert.deepStrictEqual(hslPalette(2).map((_) => _.map((x) => x.toString(16).padStart(2, "0")).join("")), ["ff0000", "00ffff"]);
+});
+it("renders the correct HSL palette - 3", () => {
+    assert.deepStrictEqual(hslPalette(3).map((_) => _.map((x) => x.toString(16).padStart(2, "0")).join("")), ["ff0000", "00ff00", "0000ff"]);
+});
+it("renders the correct HSL palette - 4", () => {
+    assert.deepStrictEqual(hslPalette(4).map((_) => _.map((x) => x.toString(16).padStart(2, "0")).join("")), ["ff0000", "7fff00", "00ffff", "7f00ff"]);
+});
+it("renders the correct HSL palette - 5", () => {
+    assert.deepStrictEqual(hslPalette(5).map((_) => _.map((x) => x.toString(16).padStart(2, "0")).join("")), ["ff0000", "ccff00", "00ff66", "0066ff", "cb00ff"]);
+});
+it("renders the correct HSL palette - 6", () => {
+    assert.deepStrictEqual(hslPalette(6).map((_) => _.map((x) => x.toString(16).padStart(2, "0")).join("")), ["ff0000", "ffff00", "00ff00", "00ffff", "0000ff", "ff00ff"]);
+});
+it("renders the correct HSL palette - 7", () => {
+    assert.deepStrictEqual(hslPalette(7).map((_) => _.map((x) => x.toString(16).padStart(2, "0")).join("")), ["ff0000", "ffda00", "48ff00", "00ff91", "0091ff", "4800ff", "ff00da"]);
+});
+it("renders the correct HSV palette - 1", () => {
+    assert.deepStrictEqual(hsvPalette(1).map((_) => _.map((x) => x.toString(16).padStart(2, "0")).join("")), ["ff0000"]);
+});
+//# sourceMappingURL=palette.test.js.map

package/lib/graphics/palette.test.js.map

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

package/lib/graphics/render-loop.d.ts

@@ -0,0 +1,76 @@
+import type { Canvas } from "./canvas.js";
+/**
+ * The amount of milliseconds your can spend in a frame, if you want to
+ * reach a frame rate of 60 FPS.
+ */
+export declare const MS_PER_FRAME_60FPS: number;
+/**
+ * The signature of a function that is called to draw a frame.
+ */
+export type RenderLoopCallback = (delta: number, timestamp: number) => unknown;
+/**
+ * Configuration for a {@linkcode RenderLoop},
+ */
+export interface RenderLoopOptions {
+    /**
+     * Should the current frames per second be rendered onto the canvas
+     * each frame?
+     */
+    drawFps: boolean;
+    /**
+     * Should the buffer be cleared or faded to black before each frame?
+     */
+    onRefresh: "clear";
+}
+/**
+ * Conveniently provides a way to have a render loop called at
+ * a constant frame rate.
+ */
+export declare class RenderLoop {
+    #private;
+    /**
+     * The {@linkcode Canvas} we're rendering to.
+     */
+    readonly canvas: Canvas;
+    /**
+     * A function that we call when a new frame should be drawn.
+     */
+    readonly renderLoop: RenderLoopCallback;
+    /**
+     * The configuration that was used for this render loop.
+     */
+    readonly options: Readonly<Partial<RenderLoopOptions>>;
+    /**
+     * The time at which we drew the last frame to the offscreen buffer.
+     */
+    private previousTimestampDraw;
+    /**
+     * The ID of our {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame requestAnimationFrame} request.
+     */
+    private frameRequestId;
+    /**
+     * The ID of our {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/setTimeout setTimeout}-based
+     * offscreen rendering loop.
+     */
+    private drawTimeout;
+    /**
+     * Retrieves the amount of frames drawn to the DOM throughout the loops lifetime.
+     * @returns The frame count.
+     */
+    get frameCounter(): number;
+    /**
+     * Constructs a new {@linkcode RenderLoop}.
+     * @param renderLoop - The function to call when a new frame should be drawn.
+     * @param canvas - The canvas we're rendering to.
+     * @param options - The configuration for thie {@linkcode RenderLoop}.
+     */
+    constructor(renderLoop: RenderLoopCallback, canvas: Canvas, options?: Partial<RenderLoopOptions>);
+    /**
+     * Stop the render loop.
+     */
+    block(): void;
+    /**
+     * Start the render loop.
+     */
+    unblock(): void;
+}

package/lib/graphics/render-loop.js

@@ -0,0 +1,114 @@
+/**
+ * The amount of milliseconds your can spend in a frame, if you want to
+ * reach a frame rate of 60 FPS.
+ */
+export const MS_PER_FRAME_60FPS = /* __PURE __ */ 1000 / 60;
+/**
+ * Conveniently provides a way to have a render loop called at
+ * a constant frame rate.
+ */
+export class RenderLoop {
+    /**
+     * The {@linkcode Canvas} we're rendering to.
+     */
+    canvas;
+    /**
+     * A function that we call when a new frame should be drawn.
+     */
+    renderLoop;
+    /**
+     * The configuration that was used for this render loop.
+     */
+    options;
+    /**
+     * The time at which we drew the last frame to the offscreen buffer.
+     */
+    previousTimestampDraw;
+    /**
+     * The ID of our {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame requestAnimationFrame} request.
+     */
+    frameRequestId = null;
+    /**
+     * The ID of our {@linkcode https://developer.mozilla.org/en-US/docs/Web/API/setTimeout setTimeout}-based
+     * offscreen rendering loop.
+     */
+    drawTimeout = null;
+    /**
+     * How many frames we've drawn to the DOM throughout the loops lifetime.
+     */
+    #frameCounter = 0;
+    /**
+     * Retrieves the amount of frames drawn to the DOM throughout the loops lifetime.
+     * @returns The frame count.
+     */
+    get frameCounter() {
+        return this.#frameCounter;
+    }
+    /**
+     * Constructs a new {@linkcode RenderLoop}.
+     * @param renderLoop - The function to call when a new frame should be drawn.
+     * @param canvas - The canvas we're rendering to.
+     * @param options - The configuration for thie {@linkcode RenderLoop}.
+     */
+    constructor(renderLoop, canvas, options = {}) {
+        this.canvas = canvas;
+        this.options = options;
+        this.renderLoop = renderLoop;
+        this.previousTimestampDraw = Date.now();
+    }
+    /**
+     * Stop the render loop.
+     */
+    block() {
+        if (this.frameRequestId !== null) {
+            cancelAnimationFrame(this.frameRequestId);
+            this.frameRequestId = null;
+        }
+        if (this.drawTimeout !== null) {
+            clearTimeout(this.drawTimeout);
+            this.drawTimeout = null;
+        }
+    }
+    /**
+     * Start the render loop.
+     */
+    unblock() {
+        if (this.frameRequestId !== null) {
+            return;
+        }
+        this.frameRequestId = requestAnimationFrame(this.#drawFrame);
+    }
+    /**
+     * The duration it took to produce previous frames.
+     * This is used for the frame graph.
+     */
+    #frameTimes = [];
+    /**
+     * Draws a new frame to the offscreen buffer.
+     */
+    #drawFrame = () => {
+        this.frameRequestId = null;
+        const timestamp = Date.now();
+        const timeDelta = timestamp - this.previousTimestampDraw;
+        if (this.options.onRefresh === "clear") {
+            this.canvas.clearWith(0);
+        }
+        this.renderLoop(timeDelta, timestamp);
+        const frameTime = Date.now() - timestamp;
+        if (this.options.drawFps) {
+            const recordCount = this.#frameTimes.unshift(frameTime);
+            if (10000 < recordCount) {
+                this.#frameTimes.splice(5000, 5000);
+            }
+        }
+        this.previousTimestampDraw = timestamp;
+        this.canvas.update();
+        if (this.options.drawFps) {
+            this.canvas.renderFpsInfo(this.#frameTimes, frameTime, timeDelta);
+        }
+        this.canvas.render();
+        this.unblock();
+        ++this.#frameCounter;
+    };
+}
+//# sourceMappingURL=render-loop.js.map

package/lib/graphics/render-loop.js.map

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

package/lib/graphics/shader.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Provides the input as-is.
+ *
+ * This method exists only to make use of the template string tag in code,
+ * which allows us to use in-IDE support for GLSL, even if there is no build
+ * process to interpret the tag.
+ * @param input - Should only be the source of a fragment shader.
+ * @returns The fragment shader as-is.
+ */
+export declare const frag: (input: TemplateStringsArray) => string;
+/**
+ * Provides the input as-is.
+ *
+ * This method exists only to make use of the template string tag in code,
+ * which allows us to use in-IDE support for GLSL, even if there is no build
+ * process to interpret the tag.
+ * @param input - Should only be the source of a vertex shader.
+ * @returns The vertex shader as-is.
+ */
+export declare const vert: (input: TemplateStringsArray) => string;
+/**
+ * Construction options for a {@linkcode !WebGLShader}.
+ */
+export interface ShaderOptions {
+    /**
+     * The GLSL source code of the shader.
+     */
+    source: string;
+    /**
+     * The type of the shader.
+     */
+    type: WebGL2RenderingContext["FRAGMENT_SHADER"] | WebGL2RenderingContext["VERTEX_SHADER"];
+}
+/**
+ * Constructs a new shader.
+ * @param gl - The rendering context in which to create the shader.
+ * @param options - The construction options for the shader.
+ * @returns The shader.
+ */
+export declare const createShader: (gl: WebGL2RenderingContext, options: ShaderOptions) => WebGLShader;
+/**
+ * Creates a new WebGL program.
+ * @param gl - The rendering context in which to create the program.
+ * @param shaders - The shaders we want to create.
+ * @param transformFeedbackVaryings - Which values to record in transform
+ * feedback buffer? See {@linkcode !WebGLTransformFeedback}.
+ * @returns The program.
+ */
+export declare const createGLProgram: (gl: WebGL2RenderingContext, shaders: Array<ShaderOptions>, transformFeedbackVaryings: Array<string> | null) => WebGLProgram;
+/**
+ * Create a buffer with random data in 2 channels (red/green).
+ * @param width - Width of the buffer.
+ * @param height - Height of the buffer.
+ * @returns The buffer.
+ */
+export declare const randomRGData: (width: number, height: number) => Uint8Array<ArrayBuffer>;

package/lib/graphics/shader.js

@@ -0,0 +1,80 @@
+import { mustExist } from "../data/nil.js";
+import { InvalidOperationError } from "../errors/InvalidOperationError.js";
+/**
+ * Provides the input as-is.
+ *
+ * This method exists only to make use of the template string tag in code,
+ * which allows us to use in-IDE support for GLSL, even if there is no build
+ * process to interpret the tag.
+ * @param input - Should only be the source of a fragment shader.
+ * @returns The fragment shader as-is.
+ */
+export const frag = (input) => input.join();
+/**
+ * Provides the input as-is.
+ *
+ * This method exists only to make use of the template string tag in code,
+ * which allows us to use in-IDE support for GLSL, even if there is no build
+ * process to interpret the tag.
+ * @param input - Should only be the source of a vertex shader.
+ * @returns The vertex shader as-is.
+ */
+export const vert = (input) => input.join();
+/**
+ * Constructs a new shader.
+ * @param gl - The rendering context in which to create the shader.
+ * @param options - The construction options for the shader.
+ * @returns The shader.
+ */
+export const createShader = (gl, options) => {
+    const shader = mustExist(gl.createShader(options.type));
+    const shader_source = options.source.replace(/^\s*/, "");
+    gl.shaderSource(shader, shader_source);
+    gl.compileShader(shader);
+    const compileStatus = gl.getShaderParameter(shader, gl.COMPILE_STATUS);
+    if (!compileStatus) {
+        const errorMessage = gl.getShaderInfoLog(shader);
+        throw new InvalidOperationError(`Could not compile shader\n${errorMessage ?? "<no error message>"}`);
+    }
+    return shader;
+};
+/**
+ * Creates a new WebGL program.
+ * @param gl - The rendering context in which to create the program.
+ * @param shaders - The shaders we want to create.
+ * @param transformFeedbackVaryings - Which values to record in transform
+ * feedback buffer? See {@linkcode !WebGLTransformFeedback}.
+ * @returns The program.
+ */
+export const createGLProgram = (gl, shaders, transformFeedbackVaryings) => {
+    const program = mustExist(gl.createProgram());
+    for (const shader_info of shaders) {
+        const shader = createShader(gl, shader_info);
+        gl.attachShader(program, shader);
+    }
+    if (transformFeedbackVaryings !== null) {
+        gl.transformFeedbackVaryings(program, transformFeedbackVaryings, gl.INTERLEAVED_ATTRIBS);
+    }
+    gl.linkProgram(program);
+    const link_status = gl.getProgramParameter(program, gl.LINK_STATUS);
+    if (!link_status) {
+        const error_message = gl.getProgramInfoLog(program);
+        throw new InvalidOperationError(`Could not link program.\n${error_message ?? "<no error message>"}`);
+    }
+    return program;
+};
+/**
+ * Create a buffer with random data in 2 channels (red/green).
+ * @param width - Width of the buffer.
+ * @param height - Height of the buffer.
+ * @returns The buffer.
+ */
+export const randomRGData = (width, height) => {
+    const data = new Array();
+    for (let i = 0; i < width * height; ++i) {
+        data.push(Math.random() * 255.0);
+        data.push(Math.random() * 255.0);
+    }
+    return new Uint8Array(data);
+};
+//# sourceMappingURL=shader.js.map

package/lib/graphics/shader.js.map

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

package/lib/log/log.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Describes the most simple logger.
+ */
+export interface BareLogger {
+    /**
+     * Logs a message.
+     * @param message - The message to log.
+     * @param args - Additional arguments to log.
+     */
+    log(message: string, ...args: Array<unknown>): void;
+}

package/lib/log/log.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log.js.map

package/lib/log/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../source/log/log.ts"],"names":[],"mappings":""}

package/lib/log/report.d.ts

@@ -0,0 +1,57 @@
+import { TreeNode } from "../data/tree.js";
+import type { BareLogger } from "./log.js";
+/**
+ * An entry of a {@linkcode Report}.
+ */
+export interface ReportEntry {
+    /**
+     * The message in the entry.
+     */
+    message: string;
+    /**
+     * An optional key-value hash, that might have been
+     * provided with the entry.
+     */
+    context: Record<string, unknown> | undefined;
+}
+/**
+ * Ensures an origin stays within reasonable display size.
+ * @param origin - The original log origin.
+ * @returns A shortened origin for display.
+ */
+export declare const makeLogOrigin: (origin: string) => string;
+/**
+ * A hierarchical background report/log.
+ */
+export declare class Report extends TreeNode<Report> {
+    #private;
+    /**
+     * The ID of this report.
+     */
+    readonly origin: string;
+    /**
+     * Retrieve the message store.
+     * @returns The message store.
+     */
+    get store(): Map<string, Array<ReportEntry>>;
+    /**
+     * Constructs a new report.
+     * @param origin - The ID of this report.
+     * @param parent - The paren report for this report.
+     * @throws {@linkcode InvalidOperationError} When the origin was already
+     * used by another report in this hierarchy.
+     */
+    constructor(origin: string, parent?: Report);
+    /**
+     * Put an entry into the report.
+     * @param message - The message to add.
+     * @param context - An arbitrary key-value object to store with the message.
+     */
+    log(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Prints the contents of the report.
+     * @param logger - A logger to use to print the report.
+     * @param depth - How deep to indent this part of the report.
+     */
+    aggregate(logger: BareLogger, depth?: number): void;
+}

package/lib/log/report.js

@@ -0,0 +1,88 @@
+import { hashCyrb53, indent } from "../data/string.js";
+import { TreeNode } from "../data/tree.js";
+import { InvalidOperationError } from "../errors/InvalidOperationError.js";
+/**
+ * Ensures an origin stays within reasonable display size.
+ * @param origin - The original log origin.
+ * @returns A shortened origin for display.
+ */
+export const makeLogOrigin = (origin) => origin.includes("\n") ? hashCyrb53(origin) : origin;
+/**
+ * A hierarchical background report/log.
+ */
+export class Report extends TreeNode {
+    /**
+     * The ID of this report.
+     */
+    origin;
+    /**
+     * Our storage for all logged messages.
+     */
+    #store = new Map();
+    /**
+     * Retrieve the message store.
+     * @returns The message store.
+     */
+    get store() {
+        return this.parent?.store ?? this.#store;
+    }
+    /**
+     * Constructs a new report.
+     * @param origin - The ID of this report.
+     * @param parent - The paren report for this report.
+     * @throws {@linkcode InvalidOperationError} When the origin was already
+     * used by another report in this hierarchy.
+     */
+    constructor(origin, parent) {
+        super(parent);
+        if (this.store.has(origin)) {
+            throw new InvalidOperationError(`The origin '${origin}' was already used in this report.`);
+        }
+        this.origin = origin;
+    }
+    /**
+     * Retrieves an entry of the store for the given origin.
+     * @param origin - The origin of the entry.
+     * @returns The store entry with that origin.
+     */
+    #getStoreEntry(origin) {
+        if (!this.#store.has(origin)) {
+            this.#store.set(origin, new Array());
+        }
+        return this.#store.get(origin);
+    }
+    /**
+     * Put an entry into the report.
+     * @param message - The message to add.
+     * @param context - An arbitrary key-value object to store with the message.
+     */
+    log(message, context) {
+        this.#getStoreEntry(makeLogOrigin(this.origin))?.push({ context, message });
+    }
+    /**
+     * Prints the contents of the report.
+     * @param logger - A logger to use to print the report.
+     * @param depth - How deep to indent this part of the report.
+     */
+    aggregate(logger, depth = 0) {
+        for (const [origin, records] of this.#store.entries()) {
+            if (origin !== this.origin) {
+                continue;
+            }
+            logger.log(indent(origin, depth));
+            for (const entry of records) {
+                logger.log(indent(` - ${entry.message}`, depth));
+                if (entry.context) {
+                    logger.log(indent(JSON.stringify(entry.context, undefined, depth + 4), depth));
+                }
+            }
+        }
+        if (this.children.size === 0) {
+            return;
+        }
+        for (const child of this.children) {
+            child.aggregate(logger, depth + 1);
+        }
+    }
+}
+//# sourceMappingURL=report.js.map

package/lib/log/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../source/log/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAmB3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAU,EAAE,CACvD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,QAAgB;IAC3C;;OAEG;IACM,MAAM,CAAS;IACxB;;OAEG;IACH,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE/C;;;OAGG;IACH,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,YAAY,MAAc,EAAE,MAAe;QAC1C,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,qBAAqB,CAC9B,eAAe,MAAM,oCAAoC,CACzD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,MAAc;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,EAAe,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAe,EAAE,OAAiC;QACrD,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,MAAkB,EAAE,KAAK,GAAG,CAAC;QACtC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC5B,SAAS;YACV,CAAC;YAED,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;gBACjD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBACnB,MAAM,CAAC,GAAG,CACT,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAClE,CAAC;gBACH,CAAC;YACF,CAAC;QACF,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO;QACR,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;IACF,CAAC;CACD"}

package/lib/math/core.d.ts

@@ -0,0 +1,85 @@
+/**
+ * `PI` times 2.
+ */
+export declare const TWO_PI: number;
+/**
+ * Converts the degrees to radians.
+ * @param degrees - The degrees to convert to radians.
+ * @returns The degrees in radians.
+ */
+export declare const degreesToRadians: (degrees: number) => number;
+/**
+ * Convertrs the radians to degrees.
+ * @param radians - The radians to convert to degrees.
+ * @returns The radians as degrees.
+ */
+export declare const radiansToDegrees: (radians: number) => number;
+/**
+ * Calculates the sine for a given degree value.
+ * @param value - The value in degrees to calculate the sine for.
+ * @returns The sine for the given value.
+ */
+export declare const sinDegrees: (value: number) => number;
+/**
+ * Calculates the cosine for a given degree value.
+ * @param value - The value in degrees to calculate the cosine for.
+ * @returns The cosine for the given value.
+ */
+export declare const cosDegrees: (value: number) => number;
+/**
+ * Calculates the distance between two vectors.
+ * @param x1 - The X component of the first vector.
+ * @param y1 - The Y comoinent of the first vector.
+ * @param x2 - The X component of the second vector.
+ * @param y2 - The Y component of the second vector.
+ * @returns The distance between the two vectors.
+ */
+export declare const distance: (x1: number, y1: number, x2: number, y2: number) => number;
+/**
+ * Finds the integer square root of a positive number.
+ * @param value - The value to calcuate the square root for.
+ * @returns The square root for the given value.
+ */
+export declare const isqrt: (value: number) => number;
+/**
+ * Checks whether a number is an integer.
+ * @param value - The value to check.
+ * @returns `true` when the value is an integer, `false` otherwise.
+ */
+export declare const isInteger: (value: number) => boolean;
+/**
+ * Ensures a given value is within a given boundary.
+ * @param input - The number to clamp.
+ * @param floor - The lower bound.
+ * @param ceil - The upper bound.
+ * @returns The number clamped to the desired range.
+ */
+export declare const clamp: (input: number, floor: number, ceil: number) => number;
+/**
+ * Rounds a given number to the next highest value.
+ * @param input - The number to round.
+ * @param fractionDigits - The amount of digits to retain in the fraction.
+ * @returns The rounded number.
+ */
+export declare const ceilTo: (input: number, fractionDigits?: number) => number;
+/**
+ * Rounds a given number to the next lowest value.
+ * @param input - The number to round.
+ * @param fractionDigits - The amount of digits to retain in the fraction.
+ * @returns The rounded number.
+ */
+export declare const floorTo: (input: number, fractionDigits?: number) => number;
+/**
+ * Rounds a given number to the next closest value.
+ * @param input - The number to round.
+ * @param fractionDigits - The amount of digits to retain in the fraction.
+ * @returns The rounded number.
+ */
+export declare const roundTo: (input: number, fractionDigits?: number) => number;
+/**
+ * Cuts off digits of a number.
+ * @param input - The number to round.
+ * @param fractionDigits - The amount of digits to retain in the fraction.
+ * @returns The rounded number.
+ */
+export declare const truncTo: (input: number, fractionDigits?: number) => number;