@oidoid/void 0.1.0-4 → 0.1.0-7

package/dist/src/graphics/sprite.js

@@ -0,0 +1,301 @@
+import { animCels, celMillis } from "../graphics/atlas.js";
+import { boxHits } from "../types/geo.js";
+import { mod } from "../utils/math.js";
+export const drawableBytes = 12;
+/** granularity (0.015625) of `Drawable` coords. */
+export const drawableEpsilon = 1 / 64;
+export const drawableMaxWH = { w: 4095, h: 4095 };
+/**
+ * everything not requiring an atlas. the box is the drawn region. assume little
+ * endian.
+ *
+ * 0 xxxx xxxx x [-131072, 131071.984375] (1/64th fixed-point). 1b sign, 17b
+ * 1 xxxx xxxx int, 6b fraction.
+ * 2 xxxx xxxx
+ * 3 yyyy yyyy y.
+ * 4 yyyy yyyy
+ * 5 yyyy yyyy
+ * 6 sxyz llll stretch, flip x, flip y, zend, z layer (4b).
+ * 7 wwww wwww width [0, 4095]. zero means discard.
+ * 8 hhhh wwww height. zero means discard.
+ * 9 hhhh hhhh
+ * a iiic cccc animation ID [0, 2047], animation cel [0, 31].
+ * b iiii iiii
+ *
+ * animations default to looping without CPU interaction.
+ * @internal
+ */
+export class Drawable {
+    i;
+    #pool;
+    constructor(pool, i) {
+        this.#pool = pool;
+        this.i = i;
+    }
+    above(draw) {
+        const compare = this.z === draw.z
+            ? (draw.zend ? draw.y + draw.h : draw.y) -
+                (this.zend ? this.y + this.h : this.y)
+            : this.z - draw.z;
+        return compare < 0;
+    }
+    get cel() {
+        const iiic_cccc = this.#pool.view.getUint8(this.i + 10);
+        return iiic_cccc & 0x1f;
+    }
+    /**
+     * [0, 31]. rendered cel offset. call reset() to play animation from start.
+     */
+    set cel(cel) {
+        const iiic_cccc = this.#pool.view.getUint8(this.i + 10);
+        this.#pool.view.setUint8(this.i + 10, (iiic_cccc & ~0x1f) | (cel & 0x1f));
+    }
+    /** test if render area overlaps box or sprite render area. */
+    clips(box) {
+        return boxHits(this, box);
+    }
+    get flipX() {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        return !!(sxyz_llll & 0x40);
+    }
+    set flipX(flip) {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        this.#pool.view.setUint8(this.i + 6, (sxyz_llll & ~0x40) | (-flip & 0x40));
+    }
+    get flipY() {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        return !!(sxyz_llll & 0x20);
+    }
+    set flipY(flip) {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        this.#pool.view.setUint8(this.i + 6, (sxyz_llll & ~0x20) | (-flip & 0x20));
+    }
+    get h() {
+        const h12_wwww = this.#pool.view.getUint16(this.i + 8, true);
+        return h12_wwww >>> 4;
+    }
+    /** [0, 4095]. */
+    set h(h) {
+        const h12_wwww = this.#pool.view.getUint16(this.i + 8, true);
+        this.#pool.view.setUint16(this.i + 8, (h12_wwww & ~(0xfff << 4)) | ((h & 0xfff) << 4), true);
+    }
+    get id() {
+        const i11_c5 = this.#pool.view.getUint16(this.i + 10, true);
+        return (i11_c5 >>> 5) & 0x7ff;
+    }
+    /** [0, 2047]. */
+    set id(id) {
+        const i11_c5 = this.#pool.view.getUint16(this.i + 10, true);
+        this.#pool.view.setUint16(this.i + 10, (i11_c5 & ~(0x7ff << 5)) | ((id & 0x7ff) << 5), true);
+    }
+    get stretch() {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        return !!(sxyz_llll & 0x80);
+    }
+    /** wrap texture (default) or stretch to width and height. */
+    set stretch(stretch) {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        this.#pool.view.setUint8(this.i + 6, (sxyz_llll & ~0x80) | (-stretch & 0x80));
+    }
+    get w() {
+        const hhhh_w12 = this.#pool.view.getUint16(this.i + 7, true);
+        return hhhh_w12 & 0xfff;
+    }
+    /** [0, 4095]. */
+    set w(w) {
+        const hhhh_w12 = this.#pool.view.getUint16(this.i + 7, true);
+        this.#pool.view.setUint16(this.i + 7, (hhhh_w12 & ~0xfff) | (w & 0xfff), true);
+    }
+    get x() {
+        const y8_x24 = this.#pool.view.getUint32(this.i + 0, true);
+        return ((y8_x24 << 8) >> 8) / 64; // signed shift.
+    }
+    /** [-131072, 131071.984375] with 1/64th (0.015625) granularity. */
+    set x(x) {
+        const y8_x24 = this.#pool.view.getUint32(this.i + 0, true);
+        this.#pool.view.setUint32(this.i + 0, (y8_x24 & ~0xff_ffff) | ((x * 64) & 0xff_ffff), true);
+    }
+    get xy() {
+        return { x: this.x, y: this.y };
+    }
+    set xy(xy) {
+        this.x = xy.x;
+        this.y = xy.y;
+    }
+    get y() {
+        const sxyz_llll_y24 = this.#pool.view.getUint32(this.i + 3, true);
+        return ((sxyz_llll_y24 << 8) >> 8) / 64; // signed shift.
+    }
+    /** [-131072, 131071.984375] with 1/64th (0.015625) granularity. */
+    set y(y) {
+        const sxyz_llll_y24 = this.#pool.view.getUint32(this.i + 3, true);
+        this.#pool.view.setUint32(this.i + 3, (sxyz_llll_y24 & ~0xff_ffff) | ((y * 64) & 0xff_ffff), true);
+    }
+    get z() {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        return (sxyz_llll & 0xf);
+    }
+    /** layer [0 (closest), 14 (furthest)]; 15 is hidden. */
+    set z(z) {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        this.#pool.view.setUint8(this.i + 6, (sxyz_llll & ~0xf) | (z & 0xf));
+    }
+    get zend() {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        return !!(sxyz_llll & 0x10);
+    }
+    /** z-order by top (default) or bottom of box. */
+    set zend(end) {
+        const sxyz_llll = this.#pool.view.getUint8(this.i + 6);
+        this.#pool.view.setUint8(this.i + 6, (sxyz_llll & ~0x10) | (-end & 0x10));
+    }
+}
+// to-do: can I declaration merge or namespace merge away from the tag type?
+export class Sprite extends Drawable {
+    #atlas;
+    #hitbox;
+    #hurtbox;
+    #looper;
+    constructor(pool, i, atlas, looper) {
+        super(pool, i);
+        this.#atlas = atlas;
+        this.#looper = looper;
+    }
+    get anim() {
+        return this.#atlas.anim[this.tag];
+    }
+    get flipX() {
+        return super.flipX;
+    }
+    set flipX(flip) {
+        if (this.flipX === flip)
+            return;
+        super.flipX = flip;
+        this.#hitbox = undefined;
+        this.#hurtbox = undefined;
+    }
+    get flipY() {
+        return super.flipY;
+    }
+    set flipY(flip) {
+        if (this.flipY === flip)
+            return;
+        super.flipY = flip;
+        this.#hitbox = undefined;
+        this.#hurtbox = undefined;
+    }
+    get h() {
+        return super.h;
+    }
+    set h(h) {
+        if (this.h === h)
+            return;
+        super.h = h;
+        this.#hitbox = undefined;
+        this.#hurtbox = undefined;
+    }
+    get hitbox() {
+        if (this.#hitbox)
+            return this.#hitbox;
+        const { hitbox } = this.anim;
+        if (!hitbox)
+            return;
+        return (this.#hitbox ??= {
+            x: this.x + (this.flipX ? this.w - hitbox.w - hitbox.x : hitbox.x),
+            y: this.y + (this.flipY ? this.h - hitbox.h - hitbox.y : hitbox.y),
+            w: hitbox.w,
+            h: hitbox.h
+        });
+    }
+    hits(box) {
+        const hitbox = this.hitbox;
+        if (!hitbox)
+            return false;
+        const hurtbox = box instanceof Sprite ? box.hurtbox : box;
+        return !!hurtbox && boxHits(hitbox, hurtbox);
+    }
+    get hurtbox() {
+        if (this.#hurtbox)
+            return this.#hurtbox;
+        const { hurtbox } = this.anim;
+        if (!hurtbox)
+            return;
+        return (this.#hurtbox ??= {
+            x: this.x + (this.flipX ? this.w - hurtbox.w - hurtbox.x : hurtbox.x),
+            y: this.y + (this.flipY ? this.h - hurtbox.h - hurtbox.y : hurtbox.y),
+            w: hurtbox.w,
+            h: hurtbox.h
+        });
+    }
+    get id() {
+        return super.id;
+    }
+    set id(id) {
+        if (this.id === id)
+            return;
+        super.id = id;
+        this.#hitbox = undefined;
+        this.#hurtbox = undefined;
+    }
+    /** true if animation has played once. */
+    get looped() {
+        // this comparison resets after the second loop since cel can only count to
+        // 2 * anim.cels.
+        return mod(this.#currentCel - this.cel, animCels * 2) >= this.anim.cels;
+    }
+    /** sets cel to animation start. */
+    reset() {
+        this.cel = this.#currentCel; // setter truncates.
+    }
+    // to-do: unit test and catch up on unit tests elsewhere.
+    get tag() {
+        return this.#atlas.tags[this.id];
+    }
+    /** sets animation, resets cel, dimensions, hitbox, and hurtbox. */
+    set tag(tag) {
+        const anim = this.#atlas.anim[tag];
+        this.w = anim.w;
+        this.h = anim.h;
+        this.id = anim.id;
+        this.reset();
+    }
+    toString() {
+        return `Sprite{${this.tag} (${this.x} ${this.y} ${this.z}) ${this.w}×${this.h}}`;
+    }
+    get w() {
+        return super.w;
+    }
+    set w(w) {
+        if (this.w === w)
+            return;
+        super.w = w;
+        this.#hitbox = undefined;
+        this.#hurtbox = undefined;
+    }
+    get x() {
+        return super.x;
+    }
+    set x(x) {
+        if (this.x === x)
+            return;
+        super.x = x;
+        this.#hitbox = undefined;
+        this.#hurtbox = undefined;
+    }
+    get y() {
+        return super.y;
+    }
+    set y(y) {
+        if (this.y === y)
+            return;
+        super.y = y;
+        this.#hitbox = undefined;
+        this.#hurtbox = undefined;
+    }
+    /** current fractional cel in [0, 2 * anim.cels). */
+    get #currentCel() {
+        const cel = this.#looper.age / celMillis;
+        return cel % (this.anim.cels * 2);
+    }
+}
+//# sourceMappingURL=sprite.js.map

package/dist/src/graphics/sprite.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,30 @@
+export { type Font, memProp5x6 } from 'mem-font';
+export * from './ents/button-ent.ts';
+export * from './ents/cursor-ent.ts';
+export * from './ents/ent.ts';
+export * from './ents/follow-cam-ent.ts';
+export * from './ents/nine-patch-ent.ts';
+export * from './ents/text-ent.ts';
+export * from './ents/zoo.ts';
+export * from './graphics/atlas.ts';
+export * from './graphics/atlas-parser.ts';
+export * from './graphics/cam.ts';
+export * from './graphics/layer.ts';
+export * from './graphics/sprite.ts';
+export * from './input/input.ts';
+export type { PointEvent } from './input/pointer.ts';
+export * from './mem/pool.ts';
+export * from './random/random.ts';
+export * from './storage/local-storage.ts';
+export * from './text/font.ts';
+export * from './text/text-layout.ts';
+export * from './types/geo.ts';
+export * from './types/json.ts';
+export * from './types/time.ts';
+export * from './utils/async-util.ts';
+export * from './utils/canvas-util.ts';
+export * from './utils/debug.ts';
+export * from './utils/dom-util.ts';
+export * from './utils/fetch-util.ts';
+export * from './void.ts';
+export declare const version: string;

package/dist/src/index.js

@@ -0,0 +1,33 @@
+import { voidVersion } from "./types/void-version.js";
+export { memProp5x6 } from 'mem-font';
+export * from "./ents/button-ent.js";
+export * from "./ents/cursor-ent.js";
+export * from "./ents/ent.js";
+export * from "./ents/follow-cam-ent.js";
+export * from "./ents/nine-patch-ent.js";
+export * from "./ents/text-ent.js";
+export * from "./ents/zoo.js";
+export * from "./graphics/atlas.js";
+export * from "./graphics/atlas-parser.js";
+export * from "./graphics/cam.js";
+export * from "./graphics/layer.js";
+export * from "./graphics/sprite.js";
+export * from "./input/input.js";
+export * from "./mem/pool.js";
+export * from "./random/random.js";
+export * from "./storage/local-storage.js";
+export * from "./text/font.js";
+export * from "./text/text-layout.js";
+export * from "./types/geo.js";
+export * from "./types/json.js";
+export * from "./types/time.js";
+export * from "./utils/async-util.js";
+export * from "./utils/canvas-util.js";
+export * from "./utils/debug.js";
+export * from "./utils/dom-util.js";
+export * from "./utils/fetch-util.js";
+export * from "./void.js";
+export const version = voidVersion
+    ? `${voidVersion.version}+${voidVersion.published}`
+    : '?';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAY,UAAU,EAAC,MAAM,UAAU,CAAA;AAC9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAEhC,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,WAAW,CAAA;AAEzB,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW;IACxC,CAAC,CAAC,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,SAAS,EAAE;IACnD,CAAC,CAAC,GAAG,CAAA"}

package/dist/src/input/context-menu.d.ts

@@ -0,0 +1,8 @@
+/** @internal */
+export declare class ContextMenu {
+    #private;
+    enable: boolean;
+    constructor(target: EventTarget);
+    register(op: 'add' | 'remove'): this;
+    [Symbol.dispose](): void;
+}

package/dist/src/input/context-menu.js

@@ -0,0 +1,25 @@
+/** @internal */
+export class ContextMenu {
+    enable = false;
+    #target;
+    constructor(target) {
+        this.#target = target;
+    }
+    register(op) {
+        const fn = this.#target[`${op}EventListener`].bind(this.#target);
+        fn('contextmenu', this.#onContextMenu);
+        // disable long press vibration. nonpassive must be explicit.
+        fn('touchstart', this.#onContextMenu, { passive: false });
+        return this;
+    }
+    [Symbol.dispose]() {
+        this.register('remove');
+    }
+    #onContextMenu = (ev) => {
+        if (!ev.isTrusted || ev.metaKey || ev.altKey || ev.ctrlKey)
+            return;
+        if (!this.enable)
+            ev.preventDefault();
+    };
+}
+//# sourceMappingURL=context-menu.js.map

package/dist/src/input/context-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.js","sourceRoot":"","sources":["../../../src/input/context-menu.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,OAAO,WAAW;IACtB,MAAM,GAAY,KAAK,CAAA;IACd,OAAO,CAAa;IAE7B,YAAY,MAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,QAAQ,CAAC,EAAoB;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAChE,EAAE,CAAC,aAAa,EAAE,IAAI,CAAC,cAA+B,CAAC,CAAA;QACvD,6DAA6D;QAC7D,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,cAA+B,EAAE,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC,CAAA;QACxE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACzB,CAAC;IAED,cAAc,GAAG,CAAC,EAA6B,EAAQ,EAAE;QACvD,IAAI,CAAC,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO;YAAE,OAAM;QAClE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,EAAE,CAAC,cAAc,EAAE,CAAA;IACvC,CAAC,CAAA;CACF"}

package/dist/src/input/gamepad.d.ts

@@ -0,0 +1,18 @@
+/** @internal */
+export declare class Gamepad {
+    #private;
+    bits: number;
+    readonly bitByAxis: {
+        [axis: number]: [less: number, more: number];
+    };
+    readonly bitByButton: {
+        [btn: number]: number;
+    };
+    onEvent: () => void;
+    constructor(target: EventTarget);
+    get connected(): boolean;
+    register(op: 'add' | 'remove'): this;
+    reset(): void;
+    [Symbol.dispose](): void;
+    update(): void;
+}

package/dist/src/input/gamepad.js

@@ -0,0 +1,49 @@
+/** @internal */
+export class Gamepad {
+    bits = 0;
+    // to-do: support analog button values, expose connected status and vibration,
+    //        and distinct devices. would be nice if vibration could merge with
+    //        navigator.vibrate().
+    bitByAxis = {};
+    bitByButton = {};
+    onEvent = () => { };
+    #target;
+    constructor(target) {
+        this.#target = target;
+    }
+    get connected() {
+        return isSecureContext && navigator.getGamepads().filter(Boolean).length > 0;
+    }
+    register(op) {
+        const fn = this.#target[`${op}EventListener`].bind(this.#target);
+        fn('gamepadconnected', this.onEvent);
+        fn('gamepaddisconnected', this.onEvent);
+        return this;
+    }
+    reset() {
+        this.bits = 0;
+    }
+    [Symbol.dispose]() {
+        this.register('remove');
+    }
+    update() {
+        if (!isSecureContext)
+            return;
+        for (const pad of navigator.getGamepads()) {
+            for (const [index, axis] of pad?.axes.entries() ?? []) {
+                const lessMore = this.bitByAxis[index];
+                if (!lessMore)
+                    continue;
+                const bit = axis < 0 ? lessMore[0] : axis === 0 ? 0 : lessMore[1];
+                this.bits |= Math.abs(axis) >= 0.5 ? bit : 0;
+            }
+            for (const [index, btn] of pad?.buttons.entries() ?? []) {
+                const bit = this.bitByButton[index];
+                if (bit == null)
+                    continue;
+                this.bits |= btn.pressed ? bit : 0;
+            }
+        }
+    }
+}
+//# sourceMappingURL=gamepad.js.map

package/dist/src/input/gamepad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamepad.js","sourceRoot":"","sources":["../../../src/input/gamepad.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,OAAO,OAAO;IAClB,IAAI,GAAW,CAAC,CAAA;IAChB,8EAA8E;IAC9E,2EAA2E;IAC3E,8BAA8B;IACrB,SAAS,GAAmD,EAAE,CAAA;IAC9D,WAAW,GAA4B,EAAE,CAAA;IAClD,OAAO,GAAe,GAAG,EAAE,GAAE,CAAC,CAAA;IACrB,OAAO,CAAa;IAE7B,YAAY,MAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,eAAe,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAC9E,CAAC;IAED,QAAQ,CAAC,EAAoB;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAChE,EAAE,CAAC,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACpC,EAAE,CAAC,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;IACf,CAAC;IAED,CAAC,MAAM,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACzB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,eAAe;YAAE,OAAM;QAC5B,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;gBACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;gBACtC,IAAI,CAAC,QAAQ;oBAAE,SAAQ;gBACvB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;gBACjE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9C,CAAC;YACD,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;gBACxD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;gBACnC,IAAI,GAAG,IAAI,IAAI;oBAAE,SAAQ;gBACzB,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YACpC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/src/input/input.d.ts

@@ -0,0 +1,148 @@
+import type { Cam, LevelClientLocalXY } from '../graphics/cam.ts';
+import type { XY, XYZ } from '../types/geo.ts';
+import type { Millis } from '../types/time.ts';
+import type { PointType } from './pointer.ts';
+export type Chord<Button> = [Button, ...Button[]];
+export type Combo<Button> = [Chord<Button>, ...Chord<Button>[]];
+export type DefaultButton = 'L' | 'R' | 'U' | 'D' | 'A' | 'B' | 'C' | 'Click' | 'Click2' | 'ClickMiddle' | 'Menu' | 'Back';
+export type Point = LevelClientLocalXY & {
+    click: LevelClientLocalXY | undefined;
+    type: PointType | undefined;
+};
+/**
+ * doesn't consider handled. local and level positions are reevaluated each
+ * frame.
+ */
+type PointerState = Point & {
+    center: LevelClientLocalXY;
+    /** false when pinched. */
+    drag: {
+        on: boolean;
+        start: boolean;
+        end: boolean;
+    };
+    /** true if changed since last update. */
+    invalid: boolean;
+    /** may be negative. */
+    pinch: {
+        client: XY;
+        /** level / local. */
+        xy: XY;
+    } | undefined;
+    /** secondary points. */
+    secondary: Point[];
+};
+/** triggered. */
+type WheelState = {
+    delta: {
+        client: Readonly<XYZ>;
+        /** level / local. */
+        xy: XY;
+    };
+};
+/**
+ * input device abstraction. aggregates devices, records history, and provides
+ * a convenient API.
+ *
+ * devices own as much device-specific detail and as little coordination (time
+ * and device) as practical. devices avoid caching state which is the
+ * responsibility of Input. devices strive to provide the current state and
+ * nothing else.
+ *
+ * if you miss reporting on a event between long updates, you just miss it.
+ * that's the nature of polling. there's no queue.
+ *
+ * to-do: expose analog state of gamepad. offer direction as a number instead of
+ *        bool.
+ * to-do: multiplayer. possible if devices were requested instead of sought.
+ * to-do: expose input source device.
+ */
+export declare class Input<Button extends string> {
+    #private;
+    /** time allowed between combo inputs. */
+    comboMaxIntervalMillis: Millis;
+    /**
+     * true if any button, key, or click was _ever_ on. doesn't consider handled.
+     */
+    gestured: boolean;
+    /** clear buttonish inputs for rest of frame. */
+    handled: boolean;
+    /** true if _any_ input has changed since previous update. */
+    invalid: boolean;
+    /**
+     * minimum duration for an input to be considered held. durations are
+     * calculated at frame boundaries, not on actual press. devices are treated
+     * strictly as polled aggregates.
+     */
+    minHeldMillis: Millis;
+    constructor(cam: Readonly<Cam>, target: Element);
+    get anyOn(): boolean;
+    /** for debugging. */
+    get combo(): Button[][];
+    /**
+     * enable when game is paused or in photo mode to allow right clicks and long
+     * presses to save canvas.
+     */
+    get contextMenu(): {
+        enable: boolean;
+    };
+    /** doesn't consider handled. gamepads must be polled. */
+    get gamepad(): Readonly<object | undefined>;
+    /** true if bits hasn't changed for a while. */
+    get held(): boolean;
+    isAnyOn(...btns: Readonly<Chord<Button>>): boolean;
+    isAnyOnStart(...btns: Readonly<Chord<Button>>): boolean;
+    /**
+     * buttons are exact. eg, up won't match up AND down like `isOn('U')` will.
+     * combo is exact too. `['A'], ['A']` will match `['A'], ['A']` but not
+     * `['A'], ['A'], ['A']`.
+     */
+    isCombo(...combo: Readonly<Combo<Button>>): boolean;
+    /**
+     * `['A'], ['A']` will match `['A'], ['A']` and `['B'], ['A'], ['A']`. eg,
+     * double-clicks often don't care about any preceding buttons.
+     */
+    isComboEndsWith(...combo: Readonly<Combo<Button>>): boolean;
+    /** like isComboEndsWith() but test if the last button is triggered. */
+    isComboEndsWithStart(...combo: Readonly<Combo<Button>>): boolean;
+    /** like isCombo() but test if the last button is triggered. */
+    isComboStart(...combo: Readonly<Combo<Button>>): boolean;
+    isOff(...btns: Readonly<Chord<Button>>): boolean;
+    isOffStart(...btns: Readonly<Chord<Button>>): boolean;
+    /**
+     * true if all buttons are on inclusively. eg, `isOn('U')` is true when up is
+     * pressed or when up and down are pressed.
+     */
+    isOn(...btns: Readonly<Chord<Button>>): boolean;
+    isOnStart(...btns: Readonly<Chord<Button>>): boolean;
+    get key(): {
+        invalid: boolean;
+    };
+    mapDefault(): Input<Button | DefaultButton>;
+    mapGamepadAxis(less: Button, more: Button, ...axes: readonly number[]): void;
+    mapGamepadButton(btn: Button, ...indices: readonly number[]): void;
+    /** @arg codes union of KeyboardEvent.code. */
+    mapKeyboardCode(btn: Button, ...codes: readonly string[]): void;
+    mapPointerClick(btn: Button, ...clicks: readonly number[]): void;
+    get on(): Button[];
+    set onEvent(cb: () => void);
+    /** doesn't consider handled. */
+    get point(): PointerState | undefined;
+    get pointer(): {
+        dragMinClient: number;
+    };
+    register(op: 'add' | 'remove'): this;
+    reset: () => void;
+    /** true if bits has changed. */
+    get started(): boolean;
+    /**
+     * call on new frame before altering cam. dispatches always occur before an
+     * update.
+     * @arg millis duration since last update.
+     */
+    update(millis: Millis): void;
+    [Symbol.dispose](): void;
+    /** doesn't consider handled. */
+    get wheel(): Readonly<WheelState | undefined>;
+}
+export {};