@oliversalzburg/js-utils 0.0.24-dev.11 → 0.0.24-dev.13

package/graphics/index.d.ts

@@ -1,4 +1,7 @@
 export * from "./canvas-sandbox.js";
 export * from "./canvas.js";
+export * from "./canvas2d.js";
+export * from "./canvas3d.js";
 export * from "./core.js";
 export * from "./render-loop.js";
+export * from "./shader.js";

package/graphics/index.js

@@ -1,5 +1,8 @@
 export * from "./canvas-sandbox.js";
 export * from "./canvas.js";
+export * from "./canvas2d.js";
+export * from "./canvas3d.js";
 export * from "./core.js";
 export * from "./render-loop.js";
+export * from "./shader.js";
 //# sourceMappingURL=index.js.map

package/graphics/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/graphics/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/graphics/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/graphics/render-loop.d.ts

@@ -69,7 +69,7 @@ export declare class RenderLoop {
     /**
      * Constructs a new {@linkcode RenderLoop}.
      * @param renderLoop - The function to call when a new frame should be drawn.
-     * @param canvas - The {@linkcode Canvas} we're rendering to.
+     * @param canvas - The canvas we're rendering to.
      * @param options - The configuration for thie {@linkcode RenderLoop}.
      */
     constructor(renderLoop: RenderLoopCallback, canvas: Canvas, options?: Partial<RenderLoopOptions>);

package/graphics/render-loop.js

@@ -1,4 +1,3 @@
-import { blend } from "./core.js";
 /**
  * The amount of milliseconds your can spend in a frame, if you want to
  * reach a frame rate of 60 FPS.
@@ -59,7 +58,7 @@ export class RenderLoop {
     /**
      * Constructs a new {@linkcode RenderLoop}.
      * @param renderLoop - The function to call when a new frame should be drawn.
-     * @param canvas - The {@linkcode Canvas} we're rendering to.
+     * @param canvas - The canvas we're rendering to.
      * @param options - The configuration for thie {@linkcode RenderLoop}.
      */
     constructor(renderLoop, canvas, options = {}) {
@@ -103,6 +102,9 @@ export class RenderLoop {
         }
         const timestamp = new Date().getTime();
         const timeDelta = timestamp - this.previousTimestampDraw;
+        if (this.options.onRefresh === "clear") {
+            this.canvas.clearWith(0);
+        }
         this.renderLoop(timeDelta, timestamp);
         const frameTime = new Date().getTime() - timestamp;
         if (this.options.drawFps) {
@@ -110,49 +112,8 @@ export class RenderLoop {
         }
         this.previousTimestampDraw = timestamp;
         this.canvas.update();
-        if (this.options.onRefresh === "clear") {
-            this.canvas.clearWith(0);
-        }
         if (this.options.drawFps) {
-            const maxFrameTime = this.#frameTimes.reduce((max, frameTime) => {
-                if (max < frameTime) {
-                    max = frameTime;
-                }
-                return max;
-            }, 0);
-            const sumFrameTimes = this.#frameTimes.reduce((sum, frameTime) => sum + frameTime, 0);
-            const fpsAll = Math.round(this.#frameTimes.length / (sumFrameTimes / 1000)).toString();
-            const fpsFrame = 1000 / frameTime;
-            const fpsDelta = 1000 / timeDelta;
-            this.#frameTimes.splice(0, this.#frameTimes.length - this.canvas.width);
-            const frameTimes = this.#frameTimes.toReversed();
-            let currentX = this.canvas.width;
-            for (const frameTime of frameTimes) {
-                let fillColor = 0x00ff00ff;
-                let width = 1;
-                if (MS_PER_FRAME_60FPS < frameTime) {
-                    const quality = frameTime / maxFrameTime;
-                    fillColor = blend(0x00ff00ff, 0xff0000ff, Math.trunc(quality * 255)) >>> 0;
-                    width = Math.round(frameTime / MS_PER_FRAME_60FPS);
-                }
-                this.canvas.context.fillStyle = `#${fillColor.toString(16).padStart(8, "0")}`;
-                this.canvas.context.globalAlpha = 255;
-                this.canvas.context.fillRect(currentX - width, this.canvas.height, width, (frameTime / Math.max(100, maxFrameTime)) * -100);
-                currentX -= width;
-            }
-            this.canvas.context.beginPath();
-            this.canvas.context.strokeStyle = "#fff";
-            this.canvas.context.moveTo(0, this.canvas.height - MS_PER_FRAME_60FPS);
-            this.canvas.context.lineTo(this.canvas.width, this.canvas.height - MS_PER_FRAME_60FPS);
-            this.canvas.context.stroke();
-            const fpsString = `${Math.round(fpsFrame)}f ${fpsAll}∑ ${Math.round(fpsDelta)}δ`;
-            this.canvas.context.font = "13px monospace";
-            this.canvas.context.strokeStyle = "rgba( 255, 255, 255, 1)";
-            this.canvas.context.textAlign = "right";
-            this.canvas.context.textRendering = "geometricPrecision";
-            this.canvas.context.strokeText(fpsString, this.canvas.width - 3, this.canvas.height - 3);
-            this.canvas.context.fillStyle = "#000000";
-            this.canvas.context.fillText(fpsString, this.canvas.width - 3, this.canvas.height - 3);
+            this.canvas.renderFpsInfo(this.#frameTimes, frameTime, timeDelta);
         }
         this.canvas.render();
         this.unblock();

package/graphics/render-loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-loop.js","sourceRoot":"","sources":["../../source/graphics/render-loop.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,IAAI,GAAG,EAAE,CAAC;AAyB5D;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACrB;;OAEG;IACM,MAAM,CAAS;IAExB;;OAEG;IACM,UAAU,CAAqB;IAExC;;OAEG;IACM,OAAO,CAAuC;IAEvD;;OAEG;IACK,qBAAqB,CAAS;IAEtC;;OAEG;IACK,wBAAwB,CAAS;IAEzC;;;OAGG;IACM,eAAe,CAAa;IAErC;;OAEG;IACK,cAAc,GAAkB,IAAI,CAAC;IAE7C;;;OAGG;IACK,WAAW,GAAyC,IAAI,CAAC;IAEjE;;OAEG;IACH,aAAa,GAAG,CAAC,CAAC;IAElB;;;OAGG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,YACE,UAA8B,EAC9B,MAAc,EACd,UAAsC,EAAE;QAExC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,qBAAqB,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QAClD,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC,qBAAqB,CAAC;QAC3D,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACjD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC3E,CAAC;IAED;;;OAGG;IACH,WAAW,GAAkB,EAAE,CAAC;IAEhC;;OAEG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC;QAEzD,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC;QAEnD,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;QAEvC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAErB,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE;gBAC9D,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;oBACpB,GAAG,GAAG,SAAS,CAAC;gBAClB,CAAC;gBACD,OAAO,GAAG,CAAC;YACb,CAAC,EAAE,CAAC,CAAC,CAAC;YACN,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;YACtF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YACvF,MAAM,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;YAElC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxE,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YAEjD,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YACjC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,IAAI,SAAS,GAAG,UAAU,CAAC;gBAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;gBACd,IAAI,kBAAkB,GAAG,SAAS,EAAE,CAAC;oBACnC,MAAM,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;oBACzC,SAAS,GAAG,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;oBAC3E,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,kBAAkB,CAAC,CAAC;gBACrD,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC9E,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC;gBACtC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAC1B,QAAQ,GAAG,KAAK,EAChB,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,KAAK,EACL,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,GAAG,CACjD,CAAC;gBACF,QAAQ,IAAI,KAAK,CAAC;YACpB,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC;YACvE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC;YACvF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAE7B,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YACjF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,gBAAgB,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,yBAAyB,CAAC;YAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG,oBAAoB,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACzF,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAErB,IAAI,CAAC,OAAO,EAAE,CAAC;QAEf,IAAI,CAAC,wBAAwB,GAAG,SAAS,CAAC;QAC1C,EAAE,IAAI,CAAC,aAAa,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"render-loop.js","sourceRoot":"","sources":["../../source/graphics/render-loop.ts"],"names":[],"mappings":"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"}

package/graphics/shader.d.ts

@@ -0,0 +1,70 @@
+/// <reference types="@types/web" />
+/**
+ * A template literal tag, that allows syntax highliters to treat the
+ * wrapped code as GLSL.
+ * @param input - Should only be the source of a fragment shader.
+ * @returns The fragment shader as-is.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+export declare const frag: (input: TemplateStringsArray) => string;
+/**
+ * A template literal tag, that allows syntax highliters to treat the
+ * wrapped code as GLSL.
+ * @param input - Should only be the source of a vertex shader.
+ * @returns The vertex shader as-is.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+export declare const vert: (input: TemplateStringsArray) => string;
+/**
+ * Construction options for a {@linkcode !WebGLShader}.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+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.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+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.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+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.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ * @group Random
+ */
+export declare const randomRGData: (width: number, height: number) => Uint8Array;

package/graphics/shader.js

@@ -0,0 +1,90 @@
+import { InvalidOperationError } from "../errors/InvalidOperationError.js";
+import { mustExist } from "../nil.js";
+/**
+ * A template literal tag, that allows syntax highliters to treat the
+ * wrapped code as GLSL.
+ * @param input - Should only be the source of a fragment shader.
+ * @returns The fragment shader as-is.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+export const frag = (input) => input.join();
+/**
+ * A template literal tag, that allows syntax highliters to treat the
+ * wrapped code as GLSL.
+ * @param input - Should only be the source of a vertex shader.
+ * @returns The vertex shader as-is.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+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.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+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}`);
+    }
+    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.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ */
+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}`);
+    }
+    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.
+ * @group Graphics
+ * @group GLSL
+ * @group WebGL
+ * @group Random
+ */
+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/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/math/vector3.d.ts

@@ -1,5 +1,5 @@
-import { Matrix3 } from "./matrix3";
-import { Transformation } from "./transformation";
+import { Matrix3 } from "./matrix3.js";
+import { Transformation } from "./transformation.js";
 /**
  * A vector with 3 components, labeled: `X`, `Y`, `Z`.
  * @group Math

package/nil.d.ts

@@ -53,6 +53,16 @@ export declare class UnexpectedNilError extends Error {
  * @group Nullability
  */
 export declare function mustExist<TSubject>(subject: Maybe<TSubject>, errorMessage?: string): TSubject;
+/**
+ * Ensure that the passed subject is not nil; throw otherwise.
+ * @param subject - A subject that is possible nil.
+ * @param errorMessage - An optional error message to throw when the subject is nil.
+ * @typeParam TSubject - The type of the subject.
+ * @returns The subject, if it isn't nil.
+ * @throws {@linkcode UnexpectedNilError} When the subject is nil.
+ * @group Nullability
+ */
+export declare function mustExistAll<TSubject>(subject: Array<Maybe<TSubject>>, errorMessage?: string): Array<TSubject>;
 /**
  * Ensure that the passed subject is not nil; throw otherwise.
  * @param subject - A subject that is possibly nil.
@@ -61,3 +71,28 @@ export declare function mustExist<TSubject>(subject: Maybe<TSubject>, errorMessa
  * @group Nullability
  */
 export declare function assertExists<TSubject>(subject: Maybe<TSubject>): asserts subject is TSubject;
+/**
+ * Convert a nilable into a real value, if it is nil.
+ * @param nilable - The subject to convert to an optional.
+ * @param to - The value to coalese to.
+ * @returns The input value, if it wasn't nil, or the value to coalesce to.
+ * @group Nullability
+ */
+export declare function coalesce<T>(nilable: Maybe<T>, to: T): T;
+/**
+ * Drop all nil values from an array, or replaces them with another value.
+ * @param nilables - The subject to convert.
+ * @param to - The value to coalese to.
+ * @returns An array with where all values are not nil.
+ * @group Nullability
+ * @group Array
+ */
+export declare function coalesceArray<T>(nilables: Array<Maybe<T>>, to?: Maybe<T>): Array<T>;
+/**
+ * Convert a nilable into an optional argument.
+ * This means `null` is normalized to `undefined`.
+ * @param nilable - The subject to convert to an optional.
+ * @returns The value, normalized to `undefined`, if it was nil.
+ * @group Nullability
+ */
+export declare function toOptional<T>(nilable: Maybe<T>): T | undefined;

package/nil.js

@@ -51,6 +51,23 @@ export function mustExist(subject, errorMessage) {
     }
     return subject;
 }
+/**
+ * Ensure that the passed subject is not nil; throw otherwise.
+ * @param subject - A subject that is possible nil.
+ * @param errorMessage - An optional error message to throw when the subject is nil.
+ * @typeParam TSubject - The type of the subject.
+ * @returns The subject, if it isn't nil.
+ * @throws {@linkcode UnexpectedNilError} When the subject is nil.
+ * @group Nullability
+ */
+export function mustExistAll(subject, errorMessage) {
+    for (const element of subject) {
+        if (isNil(element)) {
+            throw new UnexpectedNilError(errorMessage);
+        }
+    }
+    return subject;
+}
 /**
  * Ensure that the passed subject is not nil; throw otherwise.
  * @param subject - A subject that is possibly nil.
@@ -63,4 +80,50 @@ export function assertExists(subject) {
         throw new UnexpectedNilError();
     }
 }
+/**
+ * Convert a nilable into a real value, if it is nil.
+ * @param nilable - The subject to convert to an optional.
+ * @param to - The value to coalese to.
+ * @returns The input value, if it wasn't nil, or the value to coalesce to.
+ * @group Nullability
+ */
+export function coalesce(nilable, to) {
+    if (isNil(nilable)) {
+        return to;
+    }
+    return nilable;
+}
+/**
+ * Drop all nil values from an array, or replaces them with another value.
+ * @param nilables - The subject to convert.
+ * @param to - The value to coalese to.
+ * @returns An array with where all values are not nil.
+ * @group Nullability
+ * @group Array
+ */
+export function coalesceArray(nilables, to) {
+    const result = new Array();
+    for (const nilable of nilables) {
+        if (!isNil(nilable)) {
+            result.push(nilable);
+        }
+        else if (!isNil(to)) {
+            result.push(to);
+        }
+    }
+    return result;
+}
+/**
+ * Convert a nilable into an optional argument.
+ * This means `null` is normalized to `undefined`.
+ * @param nilable - The subject to convert to an optional.
+ * @returns The value, normalized to `undefined`, if it was nil.
+ * @group Nullability
+ */
+export function toOptional(nilable) {
+    if (isNil(nilable)) {
+        return undefined;
+    }
+    return nilable;
+}
 //# sourceMappingURL=nil.js.map

package/nil.js.map

@@ -1 +1 @@
-{"version":3,"file":"nil.js","sourceRoot":"","sources":["../source/nil.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAW,OAAwB;IACtD,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,CAAC;AACnD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,EAAE,CAChB,OAAwB,EACxB,SAAkC;IAElC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,YAAY,SAAS,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;;;OAGG;IACH,YAAY,OAAO,GAAG,sBAAsB;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAW,OAAwB,EAAE,YAAqB;IACjF,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAW,OAAwB;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,kBAAkB,EAAE,CAAC;IACjC,CAAC;AACH,CAAC"}
+{"version":3,"file":"nil.js","sourceRoot":"","sources":["../source/nil.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAW,OAAwB;IACtD,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,CAAC;AACnD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,EAAE,CAChB,OAAwB,EACxB,SAAkC;IAElC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,YAAY,SAAS,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;;;OAGG;IACH,YAAY,OAAO,GAAG,sBAAsB;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAW,OAAwB,EAAE,YAAqB;IACjF,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA+B,EAC/B,YAAqB;IAErB,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,OAA0B,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAW,OAAwB;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,kBAAkB,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAI,OAAiB,EAAE,EAAK;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAI,QAAyB,EAAE,EAAa;IACvE,MAAM,MAAM,GAAG,IAAI,KAAK,EAAK,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAI,OAAiB;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@oliversalzburg/js-utils",
-  "version": "0.0.24-dev.11",
+  "version": "0.0.24-dev.13",
   "license": "MIT",
   "author": "Oliver Salzburg <oliver.salzburg@gmail.com>",
   "repository": {