@typeonce/ritmo-browser 0.10.0 → 0.11.0

package/dist/internal/buttons.js

@@ -0,0 +1,211 @@
+import * as Result from "@typeonce/ritmo/Result";
+import { directionName, directions, isVectorBinding, zero } from "./vectors.js";
+const idleState = { held: false, pressed: false, released: false };
+/**
+ * The held buttons, the bound actions, and the edges since the previous
+ * take, shared by devices with named buttons (`Gamepad`, `Pointer`) and by
+ * their live and scripted forms, so all of them build snapshots the same way.
+ */
+export const buttonTracker = (buttonNames, initial) => {
+    // Fixed at creation: a rebind swaps buttons, never the actions.
+    const names = Object.keys(initial);
+    let bindings = initial;
+    const actionsByButton = new Map();
+    const index = () => {
+        actionsByButton.clear();
+        for (const name of names) {
+            for (const button of bindings[name]) {
+                const bound = actionsByButton.get(button);
+                if (bound)
+                    bound.push(name);
+                else
+                    actionsByButton.set(button, [name]);
+            }
+        }
+    };
+    index();
+    const held = new Set();
+    const pressed = new Set();
+    const released = new Set();
+    /**
+     * Each held button and the actions it holds: those bound to it when it
+     * went down that are still bound to it.
+     */
+    const holding = new Map();
+    const pressedActions = new Set();
+    const releasedActions = new Set();
+    const isHeld = (name) => bindings[name].some((button) => holding.get(button)?.has(name) === true);
+    const up = (button) => {
+        if (!held.delete(button))
+            return;
+        released.add(button);
+        for (const name of holding.get(button) ?? [])
+            releasedActions.add(name);
+        holding.delete(button);
+    };
+    return {
+        held,
+        down(button) {
+            if (held.has(button))
+                return;
+            held.add(button);
+            pressed.add(button);
+            const bound = actionsByButton.get(button) ?? [];
+            holding.set(button, new Set(bound));
+            for (const name of bound)
+                pressedActions.add(name);
+        },
+        up,
+        upAll() {
+            for (const button of [...held])
+                up(button);
+        },
+        rebind(next) {
+            const before = names.filter(isHeld);
+            bindings = next;
+            index();
+            // A held button keeps only the actions still bound to it; new ones wait for a fresh press.
+            for (const [button, actions] of holding) {
+                const bound = actionsByButton.get(button) ?? [];
+                for (const name of actions)
+                    if (!bound.includes(name))
+                        actions.delete(name);
+            }
+            for (const name of before)
+                if (!isHeld(name))
+                    releasedActions.add(name);
+        },
+        /** The buttons and actions since the previous take; starts a new press/release window. */
+        take() {
+            const buttons = {};
+            for (const name of buttonNames) {
+                const isDown = held.has(name);
+                buttons[name] = isDown || pressed.has(name) || released.has(name)
+                    ? { held: isDown, pressed: pressed.has(name), released: released.has(name) && !isDown }
+                    : idleState;
+            }
+            const actions = {};
+            for (const name of names) {
+                const isDown = isHeld(name);
+                actions[name] = { held: isDown, pressed: pressedActions.has(name), released: releasedActions.has(name) && !isDown };
+            }
+            pressed.clear();
+            released.clear();
+            pressedActions.clear();
+            releasedActions.clear();
+            return { actions, buttons };
+        }
+    };
+};
+/** Every button idle, by name. */
+export const idleButtons = (buttonNames) => {
+    const buttons = {};
+    for (const name of buttonNames)
+        buttons[name] = idleState;
+    return buttons;
+};
+/** Every button action of `bindings` idle (vector actions are in {@link idleVectors}). */
+export const idleActions = (bindings) => {
+    const actions = {};
+    for (const [name, entry] of Object.entries(bindings))
+        if (!isVectorBinding(entry))
+            actions[name] = idleState;
+    return actions;
+};
+/** Every vector action of `bindings` at rest. */
+export const idleVectors = (bindings) => {
+    const vectors = {};
+    for (const [name, entry] of Object.entries(bindings))
+        if (isVectorBinding(entry))
+            vectors[name] = zero;
+    return vectors;
+};
+/**
+ * Each action's buttons for the button tracker, with the digital part of
+ * every vector action split into its four directions (`move.up`, ...).
+ */
+export const flattenButtons = (bindings) => {
+    const flat = {};
+    for (const [name, entry] of Object.entries(bindings)) {
+        if (isVectorBinding(entry)) {
+            const vector = entry;
+            // All four, empty when unbound (a stick-only vector), so the tracker's
+            // names stay the same whichever way a rebind binds the vector.
+            for (const direction of directions) {
+                flat[directionName(name, direction)] = (vector[direction] ?? []);
+            }
+        }
+        else
+            flat[name] = entry;
+    }
+    return flat;
+};
+/** Splits taken flat actions into the button actions of `bindings`, and whether each vector direction is held. */
+export const splitActions = (bindings, taken) => {
+    const actions = {};
+    for (const [name, entry] of Object.entries(bindings))
+        if (!isVectorBinding(entry))
+            actions[name] = taken[name];
+    return { actions, held: (vector, direction) => taken[directionName(vector, direction)]?.held === true };
+};
+/**
+ * Validates `data` as new buttons for exactly the actions of `bindings`:
+ * an object with the same action names, each a non-empty array of button
+ * names.
+ */
+export const parseButtonRebinding = (buttonNames, bindings, data, sticks = []) => {
+    const invalid = (path, message) => Result.failure({ _tag: "InvalidRebinding", path, message });
+    if (typeof data !== "object" || data === null || Array.isArray(data))
+        return invalid("", "expected an object of action names");
+    const fields = data;
+    const names = Object.keys(bindings);
+    for (const name of Object.keys(fields)) {
+        if (!names.includes(name))
+            return invalid(name, `unknown action, expected one of ${names.join(", ")}`);
+    }
+    const known = new Set(buttonNames);
+    const buttonsAt = (value, path) => {
+        if (!Array.isArray(value) || value.length === 0)
+            return invalid(path, "expected a non-empty array of button names");
+        for (let offset = 0; offset < value.length; offset++) {
+            if (!known.has(value[offset]))
+                return invalid(`${path}[${offset}]`, `expected one of ${buttonNames.join(", ")}`);
+        }
+        return Result.success([...value]);
+    };
+    const rebinding = {};
+    for (const name of names) {
+        const value = fields[name];
+        if (isVectorBinding(bindings[name])) {
+            if (typeof value !== "object" || value === null || Array.isArray(value)) {
+                return invalid(name, "expected { stick } and/or { up, down, left, right } buttons for a vector action");
+            }
+            const parts = value;
+            const vector = { _tag: "Vector" };
+            if (parts["stick"] !== undefined) {
+                if (typeof parts["stick"] !== "string" || !sticks.includes(parts["stick"]))
+                    return invalid(`${name}.stick`, `expected one of ${sticks.join(", ")}`);
+                vector["stick"] = parts["stick"];
+            }
+            const given = directions.filter((direction) => parts[direction] !== undefined);
+            if (given.length > 0) {
+                for (const direction of directions) {
+                    const buttons = buttonsAt(parts[direction], `${name}.${direction}`);
+                    if (!buttons.ok)
+                        return buttons;
+                    vector[direction] = buttons.value;
+                }
+            }
+            else if (vector["stick"] === undefined)
+                return invalid(name, "expected a stick or buttons for up, down, left, and right");
+            rebinding[name] = vector;
+            continue;
+        }
+        const buttons = buttonsAt(value, name);
+        if (!buttons.ok)
+            return buttons;
+        rebinding[name] = buttons.value;
+    }
+    return Result.success(rebinding);
+};
+//# sourceMappingURL=buttons.js.map

package/dist/internal/buttons.js.map

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

package/dist/internal/introspect.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The keys a keyboard device binds now, as they read in a lint (`" "`,
+ * `KeyW`): what a player pool compares to report two players sharing a key.
+ * Live and scripted keyboards implement it.
+ */
+export declare const boundKeys: unique symbol;
+export interface ReportsBoundKeys {
+    readonly [boundKeys]?: () => ReadonlyArray<string>;
+}
+/** Records that `owner` takes the snapshots of `device`. */
+export declare const claim: (device: object, owner: string) => void;
+/** The sources that take the snapshots of `device`. */
+export declare const ownersOf: (device: object) => ReadonlyArray<string>;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/internal/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/internal/introspect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,SAAS,eAAoC,CAAA;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,aAAa,CAAC,MAAM,CAAC,CAAA;CACnD;AAKD,4DAA4D;AAC5D,eAAO,MAAM,KAAK,WAAY,MAAM,SAAS,MAAM,KAAG,IAIrD,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,QAAQ,WAAY,MAAM,KAAG,aAAa,CAAC,MAAM,CAA6B,CAAA"}

package/dist/internal/introspect.js

@@ -0,0 +1,19 @@
+/**
+ * The keys a keyboard device binds now, as they read in a lint (`" "`,
+ * `KeyW`): what a player pool compares to report two players sharing a key.
+ * Live and scripted keyboards implement it.
+ */
+export const boundKeys = Symbol("ritmo-browser/boundKeys");
+/** Every source a device was handed to (a merge, a pool), to report a device used twice. */
+const owners = new WeakMap();
+/** Records that `owner` takes the snapshots of `device`. */
+export const claim = (device, owner) => {
+    const list = owners.get(device);
+    if (list === undefined)
+        owners.set(device, [owner]);
+    else
+        list.push(owner);
+};
+/** The sources that take the snapshots of `device`. */
+export const ownersOf = (device) => owners.get(device) ?? [];
+//# sourceMappingURL=introspect.js.map

package/dist/internal/introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../../src/internal/introspect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAA;AAM1D,4FAA4F;AAC5F,MAAM,MAAM,GAAG,IAAI,OAAO,EAAyB,CAAA;AAEnD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,KAAa,EAAQ,EAAE;IAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC/B,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;;QAC9C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC,CAAA;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAyB,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA"}

package/dist/internal/used.d.ts

@@ -0,0 +1,8 @@
+import type { ActionState } from "../Keyboard.ts";
+/**
+ * Whether any action in a snapshot was pressed or is held: the `used` of a
+ * device's snapshot. Releases do not count, since a blur or a disconnect
+ * releases everything without the player touching the device.
+ */
+export declare const anyUsed: (actions: Readonly<Record<string, ActionState>>) => boolean;
+//# sourceMappingURL=used.d.ts.map

package/dist/internal/used.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"used.d.ts","sourceRoot":"","sources":["../../src/internal/used.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD;;;;GAIG;AACH,eAAO,MAAM,OAAO,YAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,KAAG,OAMxE,CAAA"}

package/dist/internal/used.js

@@ -0,0 +1,14 @@
+/**
+ * Whether any action in a snapshot was pressed or is held: the `used` of a
+ * device's snapshot. Releases do not count, since a blur or a disconnect
+ * releases everything without the player touching the device.
+ */
+export const anyUsed = (actions) => {
+    for (const name in actions) {
+        const state = actions[name];
+        if (state.held || state.pressed)
+            return true;
+    }
+    return false;
+};
+//# sourceMappingURL=used.js.map

package/dist/internal/used.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"used.js","sourceRoot":"","sources":["../../src/internal/used.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAA8C,EAAW,EAAE;IACjF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAE,CAAA;QAC5B,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;IAC9C,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/internal/vectors.d.ts

@@ -0,0 +1,24 @@
+/** A direction and strength, with length at most 1. `y` grows down the screen. */
+export interface Vector {
+    readonly x: number;
+    readonly y: number;
+}
+/** The four directions a digital vector binding names. */
+export declare const directions: readonly ["up", "down", "left", "right"];
+/** One direction of a vector action; a keyboard timeline names it as `"move.right"`. */
+export type Direction = (typeof directions)[number];
+export declare const zero: Vector;
+/** The internal action name of one direction of a vector, for timelines and the button trackers. */
+export declare const directionName: (vector: string, direction: Direction) => string;
+/**
+ * The vector four held directions give: opposite directions cancel and a
+ * diagonal has length 1, so it is not faster than a straight line.
+ */
+export declare const digital: (up: boolean, down: boolean, left: boolean, right: boolean) => Vector;
+/** The longer of two vectors, the first on a tie: how vectors from several sources combine. */
+export declare const longer: (a: Vector, b: Vector) => Vector;
+/** Whether a binding entry is a vector binding (`Keyboard.vector`, `Gamepad.vector`). */
+export declare const isVectorBinding: (entry: unknown) => entry is {
+    readonly _tag: "Vector";
+};
+//# sourceMappingURL=vectors.d.ts.map

package/dist/internal/vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.d.ts","sourceRoot":"","sources":["../../src/internal/vectors.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0DAA0D;AAC1D,eAAO,MAAM,UAAU,YAAI,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;AAElE,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnD,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAE1C,oGAAoG;AACpG,eAAO,MAAM,aAAa,WAAY,MAAM,aAAa,SAAS,KAAG,MAAkC,CAAA;AAEvG;;;GAGG;AACH,eAAO,MAAM,OAAO,OAAQ,OAAO,QAAQ,OAAO,QAAQ,OAAO,SAAS,OAAO,KAAG,MAKnF,CAAA;AAID,+FAA+F;AAC/F,eAAO,MAAM,MAAM,MAAO,MAAM,KAAK,MAAM,KAAG,MAAqD,CAAA;AAEnG,yFAAyF;AACzF,eAAO,MAAM,eAAe,UAAW,OAAO,KAAG,KAAK,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAC+C,CAAA"}

package/dist/internal/vectors.js

@@ -0,0 +1,22 @@
+/** The four directions a digital vector binding names. */
+export const directions = ["up", "down", "left", "right"];
+export const zero = { x: 0, y: 0 };
+/** The internal action name of one direction of a vector, for timelines and the button trackers. */
+export const directionName = (vector, direction) => `${vector}.${direction}`;
+/**
+ * The vector four held directions give: opposite directions cancel and a
+ * diagonal has length 1, so it is not faster than a straight line.
+ */
+export const digital = (up, down, left, right) => {
+    const x = (right ? 1 : 0) - (left ? 1 : 0);
+    const y = (down ? 1 : 0) - (up ? 1 : 0);
+    if (x === 0 && y === 0)
+        return zero;
+    return x !== 0 && y !== 0 ? { x: x * Math.SQRT1_2, y: y * Math.SQRT1_2 } : { x, y };
+};
+const lengthSquared = (vector) => vector.x * vector.x + vector.y * vector.y;
+/** The longer of two vectors, the first on a tie: how vectors from several sources combine. */
+export const longer = (a, b) => lengthSquared(b) > lengthSquared(a) ? b : a;
+/** Whether a binding entry is a vector binding (`Keyboard.vector`, `Gamepad.vector`). */
+export const isVectorBinding = (entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry) && entry._tag === "Vector";
+//# sourceMappingURL=vectors.js.map

package/dist/internal/vectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectors.js","sourceRoot":"","sources":["../../src/internal/vectors.ts"],"names":[],"mappings":"AAMA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;AAKlE,MAAM,CAAC,MAAM,IAAI,GAAW,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;AAE1C,oGAAoG;AACpG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,SAAoB,EAAU,EAAE,CAAC,GAAG,MAAM,IAAI,SAAS,EAAE,CAAA;AAEvG;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAW,EAAE,IAAa,EAAE,IAAa,EAAE,KAAc,EAAU,EAAE;IAC3F,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;AACrF,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;AAE3F,+FAA+F;AAC/F,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEnG,yFAAyF;AACzF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAAwC,EAAE,CACtF,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAK,KAAqC,CAAC,IAAI,KAAK,QAAQ,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@typeonce/ritmo-browser",
-  "version": "0.10.0",
-  "description": "Browser fixed-step loop, keyboard actions, and input capture for Ritmo",
+  "version": "0.11.0",
+  "description": "Browser fixed-step loop, keyboard, gamepad, pointer, and touch actions, merged input, local multiplayer, and input capture for Ritmo",
   "author": "Sandro Maglione",
   "license": "MIT",
   "repository": {
@@ -19,6 +19,7 @@
     "ritmo",
     "browser",
     "keyboard",
+    "gamepad",
     "game-loop"
   ],
   "type": "module",
@@ -48,7 +49,7 @@
     "provenance": true
   },
   "dependencies": {
-    "@typeonce/ritmo": "^0.10.0"
+    "@typeonce/ritmo": "^0.11.0"
   },
   "engines": {
     "node": ">=20"