@oidoid/void 0.1.0-4 → 0.1.0-7

package/dist/src/types/geo.d.ts

@@ -0,0 +1,38 @@
+export type Box = XY & WH;
+export type WH = {
+    w: number;
+    h: number;
+};
+export type XY = {
+    x: number;
+    y: number;
+};
+export type XYZ = {
+    x: number;
+    y: number;
+    z: number;
+};
+export type CardinalDir = 'W' | 'N' | 'E' | 'S';
+export type CompassDir = CardinalDir | 'NE' | 'SE' | 'SW' | 'NW' | 'Origin';
+export declare function boxEq(l: Readonly<Box>, r: Readonly<Box>): boolean;
+export declare function boxHits(l: Readonly<Partial<XY> & WH>, r: Readonly<XY & Partial<WH>>): boolean;
+export declare function whAssign(l: WH, r: Readonly<WH>): void;
+export declare function whEq(l: Readonly<WH>, r: Readonly<WH>): boolean;
+/** l + r. */
+export declare function xyAdd(l: Readonly<XY>, r: Readonly<XY>): XY;
+/** l += r. */
+export declare function xyAddTo(l: XY, r: Readonly<XY>): void;
+export declare function xyAssign(l: XY, r: Readonly<XY>): void;
+/** nonnegative. */
+export declare function xyDistance(from: Readonly<XY>, to: Readonly<XY>): number;
+/** l / r. */
+export declare function xyDiv(l: Readonly<XY>, r: Readonly<XY>): XY;
+export declare function xyEq(l: Readonly<XY>, r: Readonly<XY>): boolean;
+/** nonnegative. */
+export declare function xyMagnitude(xy: Readonly<XY>): number;
+/** the greater of each component. */
+export declare function xyMax(l: Readonly<XY>, r: Readonly<XY>): XY;
+/** the lesser of each component. */
+export declare function xyMin(l: Readonly<XY>, r: Readonly<XY>): XY;
+/** l - r. */
+export declare function xySub(l: Readonly<XY>, r: Readonly<XY>): XY;

package/dist/src/types/geo.js

@@ -0,0 +1,61 @@
+export function boxEq(l, r) {
+    return xyEq(l, r) && whEq(l, r);
+}
+export function boxHits(l, r) {
+    const rWH = { w: r.w ?? 1, h: r.h ?? 1 }; // point? an empty box has no w/h.
+    if (!l.w || !l.h || !rWH.w || !rWH.h)
+        return false; // noncommutative.
+    const lXY = { x: l.x ?? 0, y: l.y ?? 0 };
+    return (lXY.x < r.x + rWH.w &&
+        lXY.x + l.w > r.x &&
+        lXY.y < r.y + rWH.h &&
+        lXY.y + l.h > r.y);
+}
+export function whAssign(l, r) {
+    l.w = r.w;
+    l.h = r.h;
+}
+export function whEq(l, r) {
+    return l.w === r.w && l.h === r.h;
+}
+/** l + r. */
+export function xyAdd(l, r) {
+    return { x: l.x + r.x, y: l.y + r.y };
+}
+/** l += r. */
+export function xyAddTo(l, r) {
+    l.x += r.x;
+    l.y += r.y;
+}
+export function xyAssign(l, r) {
+    l.x = r.x;
+    l.y = r.y;
+}
+/** nonnegative. */
+export function xyDistance(from, to) {
+    return xyMagnitude(xySub(from, to));
+}
+/** l / r. */
+export function xyDiv(l, r) {
+    return { x: l.x / r.x, y: l.y / r.y };
+}
+export function xyEq(l, r) {
+    return l.x === r.x && l.y === r.y;
+}
+/** nonnegative. */
+export function xyMagnitude(xy) {
+    return Math.hypot(xy.x, xy.y);
+}
+/** the greater of each component. */
+export function xyMax(l, r) {
+    return { x: Math.max(l.x, r.x), y: Math.max(l.y, r.y) };
+}
+/** the lesser of each component. */
+export function xyMin(l, r) {
+    return { x: Math.min(l.x, r.x), y: Math.min(l.y, r.y) };
+}
+/** l - r. */
+export function xySub(l, r) {
+    return { x: l.x - r.x, y: l.y - r.y };
+}
+//# sourceMappingURL=geo.js.map

package/dist/src/types/geo.js.map

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

package/dist/src/types/json.d.ts

@@ -0,0 +1,31 @@
+export type JSONValue = JSONPrimitive | JSONArray | JSONObject;
+export type JSONObject = {
+    [k: string]: JSONValue;
+};
+export type JSONArray = JSONValue[];
+export type JSONPrimitive = boolean | null | number | string;
+/**
+ * like `JSONValue` but deeply allow lossy undefined values that are easier to
+ * type but may de/serialize incorrectly. eg:
+ *
+ * - `JSON.stringify({a: 1, b: undefined, c: 3})`: `'{"a":1,"c":3}'`.
+ * - `JSON.stringify([1, undefined, 3])`: `'[1,null,3]'`.
+ * - `JSON.stringify(undefined)`: `undefined`.
+ *
+ * the last case produces unparseable JSON and must be guarded against.
+ *
+ * `JSON.stringify()` accepts `any` input so there are no typing guards. prefer
+ * plain `JSONValue`.
+ *
+ * the following inputs all throw but only the last is probable.
+ *
+ * - `JSON.parse('{a: 1, b: undefined, c: 3}')`.
+ * - `JSON.parse('[1, undefined, 3]')`.
+ * - `JSON.parse('undefined')`.
+ */
+export type PartialJSONValue = PartialJSONPrimitive | PartialJSONArray | PartialJSONObject;
+export type PartialJSONObject = {
+    [k in string]?: PartialJSONValue;
+};
+export type PartialJSONArray = PartialJSONValue[];
+export type PartialJSONPrimitive = boolean | null | number | string | undefined;

package/dist/src/types/json.js

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

package/dist/src/types/json.js.map

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

package/dist/src/types/time.d.ts

@@ -0,0 +1,19 @@
+declare global {
+    interface DateConstructor {
+        now(): UTCMillis;
+    }
+    interface Performance {
+        now(): Millis;
+    }
+}
+declare const millis: unique symbol;
+/** duration in milliseconds. */
+export type Millis = number & {
+    readonly [millis]: never;
+};
+declare const utcMillis: unique symbol;
+export type UTCMillis = number & {
+    readonly [utcMillis]: never;
+};
+export declare function dateToTimestamp(date: Readonly<Date>): string;
+export {};

package/dist/src/types/time.js

@@ -0,0 +1,10 @@
+export function dateToTimestamp(date) {
+    const yyyy = `${date.getFullYear()}`.padStart(4, '0');
+    const MM = `${date.getMonth() + 1}`.padStart(2, '0');
+    const dd = `${date.getDate()}`.padStart(2, '0');
+    const hh = `${date.getHours()}`.padStart(2, '0');
+    const mm = `${date.getMinutes()}`.padStart(2, '0');
+    const ss = `${date.getSeconds()}`.padStart(2, '0');
+    return `${yyyy}${MM}${dd}${hh}${mm}${ss}`;
+}
+//# sourceMappingURL=time.js.map

package/dist/src/types/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/types/time.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,eAAe,CAAC,IAAoB;IAClD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACrD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACpD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC/C,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAChD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAClD,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAClD,OAAO,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAA;AAC3C,CAAC"}

package/dist/src/types/void-version.d.ts

@@ -0,0 +1,7 @@
+export type VoidVersion = {
+    /** package.json `published` YYYYMMDD. */
+    published: string;
+    /** package.json semantic `version`. */
+    version: string;
+};
+export declare const voidVersion: VoidVersion;

package/dist/src/types/void-version.js

@@ -0,0 +1,2 @@
+export const voidVersion = globalThis.voidVersion;
+//# sourceMappingURL=void-version.js.map

package/dist/src/types/void-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"void-version.js","sourceRoot":"","sources":["../../../src/types/void-version.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,WAAW,GAAgB,UAAU,CAAC,WAAW,CAAA"}

package/dist/src/utils/async-util.d.ts

@@ -0,0 +1,11 @@
+import type { Millis } from '../types/time.ts';
+export declare function debounce<T extends unknown[]>(fn: (this: undefined, ...args: T) => void | Promise<void>, delay: Millis): {
+    cancel(): void;
+    (...args: T): void;
+};
+export declare function retry<T>(fn: () => Promise<T>, retries: number, delayMillis: Millis): Promise<T>;
+/** schedule a new function call overwriting any previous. */
+export declare function throttle<T extends unknown[]>(fn: (this: undefined, ...args: T) => void, period: Millis): {
+    cancel(): void;
+    (...args: T): void;
+};

package/dist/src/utils/async-util.js

@@ -0,0 +1,36 @@
+export function debounce(fn, delay) {
+    let timeout;
+    const cancel = () => clearTimeout(timeout);
+    return Object.assign((...args) => {
+        cancel();
+        timeout = setTimeout(() => fn.apply(undefined, args), delay);
+    }, { cancel });
+}
+// to-do: cancel.
+export async function retry(fn, retries, delayMillis) {
+    for (let i = 0;; i++)
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (i >= retries)
+                throw err;
+            await new Promise(fulfil => setTimeout(fulfil, delayMillis));
+            delayMillis = (delayMillis * 2);
+        }
+}
+/** schedule a new function call overwriting any previous. */
+export function throttle(fn, period) {
+    let exec = 0;
+    let timeout;
+    const cancel = () => clearTimeout(timeout);
+    return Object.assign((...args) => {
+        cancel();
+        const delay = Math.max(0, period - (performance.now() - exec));
+        timeout = setTimeout(() => {
+            exec = performance.now();
+            fn.apply(undefined, args);
+        }, delay);
+    }, { cancel });
+}
+//# sourceMappingURL=async-util.js.map

package/dist/src/utils/async-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-util.js","sourceRoot":"","sources":["../../../src/utils/async-util.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CACtB,EAAyD,EACzD,KAAa;IAEb,IAAI,OAA2B,CAAA;IAC/B,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IAC1C,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,GAAG,IAAO,EAAE,EAAE;QACb,MAAM,EAAE,CAAA;QACR,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAA;IAC9D,CAAC,EACD,EAAC,MAAM,EAAC,CACT,CAAA;AACH,CAAC;AAED,iBAAiB;AACjB,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,OAAe,EACf,WAAmB;IAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAI,CAAC,EAAE;QACnB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,OAAO;gBAAE,MAAM,GAAG,CAAA;YAC3B,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;YAC5D,WAAW,GAAG,CAAC,WAAW,GAAG,CAAC,CAAW,CAAA;QAC3C,CAAC;AACL,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CACtB,EAAyC,EACzC,MAAc;IAEd,IAAI,IAAI,GAAW,CAAW,CAAA;IAC9B,IAAI,OAA2B,CAAA;IAC/B,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IAC1C,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,GAAG,IAAO,EAAE,EAAE;QACb,MAAM,EAAE,CAAA;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;QAC9D,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;YACxB,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC3B,CAAC,EAAE,KAAK,CAAC,CAAA;IACX,CAAC,EACD,EAAC,MAAM,EAAC,CACT,CAAA;AACH,CAAC"}

package/dist/src/utils/canvas-util.d.ts

@@ -0,0 +1,7 @@
+export declare function downloadScreenshot(canvas: HTMLCanvasElement, name: string): Promise<void>;
+export declare function initCanvas(canvas: HTMLCanvasElement | undefined, mode: 'Int' | 'Fraction'): HTMLCanvasElement;
+export declare function requestFullscreen(canvas: HTMLCanvasElement): Promise<boolean>;
+/** draws a canvas to a blob URI. */
+export declare function screenshot(canvas: HTMLCanvasElement): Promise<Disposable & {
+    uri: string;
+}>;

package/dist/src/utils/canvas-util.js

@@ -0,0 +1,128 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { dateToTimestamp } from "../types/time.js";
+import { download } from "./dom-util.js";
+export async function downloadScreenshot(canvas, name) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const img = __addDisposableResource(env_1, await screenshot(canvas), false);
+        download(img.uri, `${name}-screenshot-${dateToTimestamp(new Date())}.webp`);
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
+}
+export function initCanvas(canvas, mode) {
+    canvas ??= document.createElement('canvas');
+    canvas.width = 0; // guarantee Renderer.#resize().
+    canvas.style.cursor = 'none';
+    canvas.style.display = 'block'; // no line height spacing.
+    canvas.style.outline = 'none'; // disable focus outline.
+    canvas.style.cursor = 'none';
+    if (mode === 'Int')
+        canvas.style.imageRendering = 'pixelated'; // to-do: why doesn't cam mode set this?
+    // update on each pointermove *touch* Event like *mouse* Events.
+    canvas.style.touchAction = 'none';
+    canvas.tabIndex = 0;
+    canvas.focus();
+    if (!canvas.parentNode)
+        document.body.append(canvas);
+    return canvas;
+}
+export async function requestFullscreen(canvas) {
+    if (!document.fullscreenEnabled)
+        return false;
+    if (document.fullscreenElement !== canvas)
+        try {
+            await canvas.requestFullscreen({ navigationUI: 'hide' });
+        }
+        catch {
+            return false;
+        }
+    if (!document.pointerLockElement) {
+        try {
+            await canvas.requestPointerLock({ unadjustedMovement: true });
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'NotSupportedError')
+                try {
+                    await canvas.requestPointerLock();
+                }
+                catch { }
+        }
+    }
+    return true;
+}
+/** draws a canvas to a blob URI. */
+export function screenshot(canvas) {
+    return new Promise((fulfil, reject) => {
+        canvas.toBlob(blob => {
+            if (blob) {
+                const img = {
+                    [Symbol.dispose]() {
+                        URL.revokeObjectURL(this.uri);
+                    },
+                    uri: URL.createObjectURL(blob)
+                };
+                fulfil(img);
+            }
+            else
+                reject(Error('no blob'));
+        }, 'image/webp');
+    });
+}
+//# sourceMappingURL=canvas-util.js.map

package/dist/src/utils/canvas-util.js.map

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

package/dist/src/utils/color-util.d.ts

@@ -0,0 +1 @@
+export declare function rgbaHex(rgba: number): `#${string}`;

package/dist/src/utils/color-util.js

@@ -0,0 +1,4 @@
+export function rgbaHex(rgba) {
+    return `#${rgba.toString(16).padStart(8, '0')}`;
+}
+//# sourceMappingURL=color-util.js.map

package/dist/src/utils/color-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-util.js","sourceRoot":"","sources":["../../../src/utils/color-util.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;AACjD,CAAC"}

package/dist/src/utils/debug.d.ts

@@ -0,0 +1,19 @@
+/**
+ * proxy for debug CSV query param with case-insensitive keys. when a key
+ * exists, the value is as specified or `'true'` if no value. most void values
+ * default to `'true'` when the `debug` param is empty or `'void'` is set (eg,
+ * `localhost:1234?debug` or `localhost:1234?debug=void,foo=bar`). all values
+ * default to true when `'all'` is set. extend interface for additional types.
+ * doesn't handle multiple values like `localhost:1234?debug=a=1,b=2&debug=b=3`.
+ */
+export interface Debug {
+    cam?: string;
+    input?: string;
+    /** debug render invalidations. */
+    invalid?: string;
+    mem?: string;
+    render?: 'always' | string;
+}
+export declare const debug: Readonly<Debug> | undefined;
+/** @internal */
+export declare function Debug(url: string | undefined): Debug | undefined;

package/dist/src/utils/debug.js

@@ -0,0 +1,35 @@
+export const debug = Debug(globalThis.location?.href);
+/** @internal */
+export function Debug(url) {
+    if (!url)
+        return;
+    const csv = [...new URL(url).searchParams].find(([k]) => k.toLowerCase() === 'debug')?.[1];
+    if (csv == null)
+        return;
+    const map = Object.fromEntries(csv
+        .split(',') // split KV pairs.
+        .filter(Boolean) // drop empties.
+        .map(kv => kv.split('=')) // split each pair.
+    );
+    const target = {};
+    for (const k in map)
+        target[k.toLowerCase()] = map[k] || 'true';
+    const voidKeyset = {
+        cam: undefined,
+        input: undefined,
+        mem: undefined,
+        render: undefined
+    };
+    return new Proxy(target, {
+        get(target, k) {
+            if (typeof k !== 'string')
+                return target[k];
+            k = k.toLowerCase();
+            if (target[k])
+                return target[k];
+            if (!csv || 'all' in map || (k in voidKeyset && 'void' in map))
+                return 'true';
+        }
+    });
+}
+//# sourceMappingURL=debug.js.map

package/dist/src/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../src/utils/debug.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,KAAK,GAAgC,KAAK,CACrD,UAAU,CAAC,QAAQ,EAAE,IAAI,CAC1B,CAAA;AAED,gBAAgB;AAChB,MAAM,UAAU,KAAK,CAAC,GAAuB;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAM;IAChB,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAC7C,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CACrC,EAAE,CAAC,CAAC,CAAC,CAAA;IACN,IAAI,GAAG,IAAI,IAAI;QAAE,OAAM;IACvB,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAC5B,GAAG;SACA,KAAK,CAAC,GAAG,CAAC,CAAC,kBAAkB;SAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,gBAAgB;SAChC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,mBAAmB;KAChD,CAAA;IAED,MAAM,MAAM,GAA0B,EAAE,CAAA;IACxC,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,CAAA;IAE/D,MAAM,UAAU,GAAuD;QACrE,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,MAAM,EAAE,SAAS;KAClB,CAAA;IAED,OAAO,IAAI,KAAK,CAAwB,MAAM,EAAE;QAC9C,GAAG,CAAC,MAAM,EAAE,CAAC;YACX,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,MAAM,CAAC,CAAsB,CAAC,CAAA;YAChE,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;YACnB,IAAI,MAAM,CAAC,CAAC,CAAC;gBAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;YAC/B,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,IAAI,UAAU,IAAI,MAAM,IAAI,GAAG,CAAC;gBAC5D,OAAO,MAAM,CAAA;QACjB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/utils/delay-interval.d.ts

@@ -0,0 +1,7 @@
+import type { Millis } from '../types/time.ts';
+export declare class DelayInterval {
+    #private;
+    constructor(delay: () => Millis, interval: Millis, onInterval: () => void);
+    register(op: 'add' | 'remove'): this;
+    [Symbol.dispose](): void;
+}

package/dist/src/utils/delay-interval.js

@@ -0,0 +1,29 @@
+export class DelayInterval {
+    #delay;
+    #interval;
+    #intervalID = 0;
+    #onInterval;
+    #timerID = 0;
+    constructor(delay, interval, onInterval) {
+        this.#delay = delay;
+        this.#interval = interval;
+        this.#onInterval = onInterval;
+    }
+    register(op) {
+        if (op === 'add') {
+            this.#timerID = setTimeout(() => {
+                this.#onInterval();
+                this.#intervalID = setInterval(this.#onInterval, this.#interval);
+            }, this.#delay());
+        }
+        else {
+            clearTimeout(this.#timerID);
+            clearInterval(this.#intervalID);
+        }
+        return this;
+    }
+    [Symbol.dispose]() {
+        this.register('remove');
+    }
+}
+//# sourceMappingURL=delay-interval.js.map

package/dist/src/utils/delay-interval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay-interval.js","sourceRoot":"","sources":["../../../src/utils/delay-interval.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACxB,MAAM,CAAc;IACpB,SAAS,CAAQ;IACjB,WAAW,GAAW,CAAC,CAAA;IACvB,WAAW,CAAY;IACvB,QAAQ,GAAW,CAAC,CAAA;IAEpB,YAAY,KAAmB,EAAE,QAAgB,EAAE,UAAsB;QACvE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAA;IAC/B,CAAC;IAED,QAAQ,CAAC,EAAoB;QAC3B,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,WAAW,EAAE,CAAA;gBAClB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YAClE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QACnB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC3B,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACjC,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACzB,CAAC;CACF"}

package/dist/src/utils/dom-util.d.ts

@@ -0,0 +1,3 @@
+export declare function download(uri: string, filename: string): void;
+export declare function initBody(canvas: Readonly<HTMLCanvasElement>, rgba: number): void;
+export declare function initMetaViewport(): void;

package/dist/src/utils/dom-util.js

@@ -0,0 +1,29 @@
+import { rgbaHex } from "./color-util.js";
+export function download(uri, filename) {
+    const a = document.createElement('a');
+    a.href = uri;
+    a.download = filename;
+    a.click();
+    a.remove();
+}
+export function initBody(canvas, rgba) {
+    if (canvas.parentNode !== document.body)
+        return;
+    document.body.style.margin = '0';
+    // fill the screen except for UI chrome.
+    document.body.style.width = '100dvw';
+    document.body.style.height = '100dvh';
+    document.body.style.overflow = 'hidden';
+    document.body.style.background = rgbaHex(rgba);
+}
+export function initMetaViewport() {
+    if (document.querySelector('meta[name="viewport"]'))
+        return;
+    const meta = document.createElement('meta');
+    meta.name = 'viewport';
+    // don't wait for double-tap scaling on mobile.
+    meta.content =
+        'width=device-width, maximum-scale=1, minimum-scale=1, user-scalable=no';
+    document.head.appendChild(meta);
+}
+//# sourceMappingURL=dom-util.js.map

package/dist/src/utils/dom-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-util.js","sourceRoot":"","sources":["../../../src/utils/dom-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,iBAAiB,CAAA;AAEvC,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,QAAgB;IACpD,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;IACrC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAA;IACZ,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAA;IACrB,CAAC,CAAC,KAAK,EAAE,CAAA;IACT,CAAC,CAAC,MAAM,EAAE,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,MAAmC,EACnC,IAAY;IAEZ,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,IAAI;QAAE,OAAM;IAC/C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAA;IAChC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAA;IACrC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAA;IACvC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,QAAQ,CAAC,aAAa,CAAC,uBAAuB,CAAC;QAAE,OAAM;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3C,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;IACtB,+CAA+C;IAC/C,IAAI,CAAC,OAAO;QACV,wEAAwE,CAAA;IAC1E,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC"}

package/dist/src/utils/fetch-util.d.ts

@@ -0,0 +1,3 @@
+export declare function fetchAudio(url: string): Promise<ArrayBuffer>;
+export declare function fetchImage(url: string): Promise<HTMLImageElement>;
+export declare function loadImage(img: HTMLImageElement): Promise<HTMLImageElement>;

package/dist/src/utils/fetch-util.js

@@ -0,0 +1,24 @@
+export async function fetchAudio(url) {
+    const rsp = await fetch(url, { headers: { accept: 'audio/mpeg' } });
+    if (!rsp.ok)
+        throw Error(`fetch error ${rsp.status}: ${rsp.statusText} for ${url}`);
+    const type = rsp.headers.get('Content-Type');
+    // to-do: ogg
+    if (!type?.startsWith('audio/mpeg'))
+        throw Error(`bad fetch response type ${type} for ${url}`);
+    return await rsp.arrayBuffer();
+}
+export function fetchImage(url) {
+    const img = new Image();
+    const promise = loadImage(img);
+    img.src = url;
+    return promise;
+}
+export async function loadImage(img) {
+    const promise = new Promise((fulfil, reject) => {
+        img.onload = () => fulfil(img);
+        img.onerror = () => reject(Error(`image load error for ${img.src}`));
+    });
+    return img.complete ? img : await promise;
+}
+//# sourceMappingURL=fetch-util.js.map

package/dist/src/utils/fetch-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-util.js","sourceRoot":"","sources":["../../../src/utils/fetch-util.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAC,OAAO,EAAE,EAAC,MAAM,EAAE,YAAY,EAAC,EAAC,CAAC,CAAA;IAC/D,IAAI,CAAC,GAAG,CAAC,EAAE;QACT,MAAM,KAAK,CAAC,eAAe,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,UAAU,QAAQ,GAAG,EAAE,CAAC,CAAA;IACxE,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAC5C,aAAa;IACb,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC;QACjC,MAAM,KAAK,CAAC,2BAA2B,IAAI,QAAQ,GAAG,EAAE,CAAC,CAAA;IAC3D,OAAO,MAAM,GAAG,CAAC,WAAW,EAAE,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAC9B,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAqB;IAErB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAC/D,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC9B,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IACF,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,OAAO,CAAA;AAC3C,CAAC"}

package/dist/src/utils/math.d.ts

@@ -0,0 +1,6 @@
+export declare function clamp(val: number, min: number, max: number): number;
+export declare function closeTo(lhs: number, rhs: number, tolerance: number): boolean;
+/** ratio is [0, 1] to return [start, end]. */
+export declare function lerp(start: number, end: number, ratio: number): number;
+/** returns positive modulo. */
+export declare function mod(dividend: number, divisor: number): number;

package/dist/src/utils/math.js

@@ -0,0 +1,18 @@
+// to-do: port tests.
+export function clamp(val, min, max) {
+    return Math.max(min, Math.min(max, val));
+}
+export function closeTo(lhs, rhs, tolerance) {
+    return Math.abs(lhs - rhs) <= tolerance;
+}
+// to-do: port tests.
+/** ratio is [0, 1] to return [start, end]. */
+export function lerp(start, end, ratio) {
+    return start + (end - start) * ratio;
+}
+// to-do: test.
+/** returns positive modulo. */
+export function mod(dividend, divisor) {
+    return ((dividend % divisor) + divisor) % divisor;
+}
+//# sourceMappingURL=math.js.map

package/dist/src/utils/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../../src/utils/math.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,GAAW,EAAE,GAAW;IACzD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAW,EAAE,SAAiB;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,SAAS,CAAA;AACzC,CAAC;AAED,qBAAqB;AACrB,8CAA8C;AAC9C,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,GAAW,EAAE,KAAa;IAC5D,OAAO,KAAK,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,KAAK,CAAA;AACtC,CAAC;AAED,eAAe;AACf,+BAA+B;AAC/B,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,OAAe;IACnD,OAAO,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,CAAA;AACnD,CAAC"}

package/dist/src/utils/vibrate.d.ts

@@ -0,0 +1 @@
+export declare function vibrate(...pattern: number[]): void;

package/dist/src/utils/vibrate.js

@@ -0,0 +1,4 @@
+export function vibrate(...pattern) {
+    navigator.vibrate?.(pattern);
+}
+//# sourceMappingURL=vibrate.js.map

package/dist/src/utils/vibrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibrate.js","sourceRoot":"","sources":["../../../src/utils/vibrate.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,GAAG,OAAiB;IAC1C,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAA;AAC9B,CAAC"}