@debuffjp/input 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# @debuffjp/input
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Action-based input across keyboard, mouse/touch/pen (Pointer Events) and gamepads (standard mapping). No dependencies.
+
+```ts
+import { Input } from "@debuffjp/input";
+
+const input = new Input(game, {
+  bindings: {
+    left: ["ArrowLeft", "KeyA", "PadLeft", "PadStickLeft"],
+    right: ["ArrowRight", "KeyD", "PadRight", "PadStickRight"],
+    jump: ["Space", "PadA", "Pointer"],
+  },
+});
+
+// inside Scene.update
+const dx = input.axis("left", "right");
+if (input.pressed("jump")) jump();
+```
+
+Edges clear automatically after each simulation step, so a tap shorter than a frame is never missed.
+
+## Binding names
+
+| Source | Names |
+| --- | --- |
+| Keyboard | [`KeyboardEvent.code`](https://developer.mozilla.org/docs/Web/API/KeyboardEvent/code): `Space`, `KeyZ`, `ArrowUp`, … |
+| Pointer | `Pointer` (primary mouse button, touch or pen) |
+| Gamepad | `PadA` `PadB` `PadX` `PadY` `PadL1` `PadR1` `PadL2` `PadR2` `PadSelect` `PadStart` `PadL3` `PadR3` `PadUp` `PadDown` `PadLeft` `PadRight` |
+| Left stick | `PadStickUp` `PadStickDown` `PadStickLeft` `PadStickRight` |
+
+## API
+
+- `input.down(action)`, `input.pressed(action)`, `input.released(action)`, `input.axis(neg, pos)`
+- `input.pointer`: `x`, `y` (logical), `down`, `pressed`, `released`, `touches`
+- `input.keys`: `down(code)`, `pressed(code)`, `released(code)`
+- `input.pads`: `stickX`, `stickY`, `connected`, `deadzone`
+- Programmatic control for tests and on-screen buttons: `keys.press/release`, `pointer.press/move/release`

package/dist/gamepad.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Button names for the W3C "standard" gamepad mapping, used in bindings as `"Pad<Name>"`,
+ * e.g. `"PadA"`, `"PadUp"`. Stick directions (`PadStickLeft` …) treat the left stick as a d-pad.
+ * https://w3c.github.io/gamepad/#remapping
+ */
+export declare const PAD_BUTTONS: {
+    readonly PadA: 0;
+    readonly PadB: 1;
+    readonly PadX: 2;
+    readonly PadY: 3;
+    readonly PadL1: 4;
+    readonly PadR1: 5;
+    readonly PadL2: 6;
+    readonly PadR2: 7;
+    readonly PadSelect: 8;
+    readonly PadStart: 9;
+    readonly PadL3: 10;
+    readonly PadR3: 11;
+    readonly PadUp: 12;
+    readonly PadDown: 13;
+    readonly PadLeft: 14;
+    readonly PadRight: 15;
+};
+export type PadButton = keyof typeof PAD_BUTTONS;
+export type PadStick = "PadStickUp" | "PadStickDown" | "PadStickLeft" | "PadStickRight";
+/** Polls the first connected standard gamepad. The Gamepad API is poll-based, so call `poll()` once per step. */
+export declare class Gamepads {
+    /** Stick deflection needed to count as a direction. */
+    deadzone: number;
+    private current;
+    private previous;
+    /** Left stick, -1..1, after the deadzone. */
+    stickX: number;
+    stickY: number;
+    connected: boolean;
+    poll(): void;
+    down(name: string): boolean;
+    pressed(name: string): boolean;
+    released(name: string): boolean;
+}
+//# sourceMappingURL=gamepad.d.ts.map

package/dist/gamepad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamepad.d.ts","sourceRoot":"","sources":["../src/gamepad.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,WAAW;aACtB,IAAI,EAAE,CAAC;aACP,IAAI,EAAE,CAAC;aACP,IAAI,EAAE,CAAC;aACP,IAAI,EAAE,CAAC;aACP,KAAK,EAAE,CAAC;aACR,KAAK,EAAE,CAAC;aACR,KAAK,EAAE,CAAC;aACR,KAAK,EAAE,CAAC;aACR,SAAS,EAAE,CAAC;aACZ,QAAQ,EAAE,CAAC;aACX,KAAK,EAAE,EAAE;aACT,KAAK,EAAE,EAAE;aACT,KAAK,EAAE,EAAE;aACT,OAAO,EAAE,EAAE;aACX,OAAO,EAAE,EAAE;aACX,QAAQ,EAAE,EAAE;CACJ,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,cAAc,GAAG,eAAe,CAAC;AAExF,iHAAiH;AACjH,qBAAa,QAAQ;IACnB,uDAAuD;IACvD,QAAQ,SAAO;IACf,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAqB;IACrC,6CAA6C;IAC7C,MAAM,SAAK;IACX,MAAM,SAAK;IACX,SAAS,UAAS;IAElB,IAAI,IAAI,IAAI,CAiBX;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1B;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7B;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9B;CACF"}

package/dist/gamepad.js

@@ -0,0 +1,69 @@
+/**
+ * Button names for the W3C "standard" gamepad mapping, used in bindings as `"Pad<Name>"`,
+ * e.g. `"PadA"`, `"PadUp"`. Stick directions (`PadStickLeft` …) treat the left stick as a d-pad.
+ * https://w3c.github.io/gamepad/#remapping
+ */
+export const PAD_BUTTONS = {
+    PadA: 0,
+    PadB: 1,
+    PadX: 2,
+    PadY: 3,
+    PadL1: 4,
+    PadR1: 5,
+    PadL2: 6,
+    PadR2: 7,
+    PadSelect: 8,
+    PadStart: 9,
+    PadL3: 10,
+    PadR3: 11,
+    PadUp: 12,
+    PadDown: 13,
+    PadLeft: 14,
+    PadRight: 15,
+};
+/** Polls the first connected standard gamepad. The Gamepad API is poll-based, so call `poll()` once per step. */
+export class Gamepads {
+    /** Stick deflection needed to count as a direction. */
+    deadzone = 0.4;
+    current = new Set();
+    previous = new Set();
+    /** Left stick, -1..1, after the deadzone. */
+    stickX = 0;
+    stickY = 0;
+    connected = false;
+    poll() {
+        [this.previous, this.current] = [this.current, this.previous];
+        this.current.clear();
+        const pad = typeof navigator !== "undefined" && navigator.getGamepads ? navigator.getGamepads().find((p) => p?.connected) : undefined;
+        this.connected = Boolean(pad);
+        this.stickX = 0;
+        this.stickY = 0;
+        if (!pad)
+            return;
+        for (const [name, index] of Object.entries(PAD_BUTTONS))
+            if (pad.buttons[index]?.pressed)
+                this.current.add(name);
+        const ax = pad.axes[0] ?? 0;
+        const ay = pad.axes[1] ?? 0;
+        this.stickX = Math.abs(ax) > this.deadzone ? ax : 0;
+        this.stickY = Math.abs(ay) > this.deadzone ? ay : 0;
+        if (this.stickX < 0)
+            this.current.add("PadStickLeft");
+        if (this.stickX > 0)
+            this.current.add("PadStickRight");
+        if (this.stickY < 0)
+            this.current.add("PadStickUp");
+        if (this.stickY > 0)
+            this.current.add("PadStickDown");
+    }
+    down(name) {
+        return this.current.has(name);
+    }
+    pressed(name) {
+        return this.current.has(name) && !this.previous.has(name);
+    }
+    released(name) {
+        return !this.current.has(name) && this.previous.has(name);
+    }
+}
+//# sourceMappingURL=gamepad.js.map

package/dist/gamepad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamepad.js","sourceRoot":"","sources":["../src/gamepad.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;CACJ,CAAC;AAKX,iHAAiH;AACjH,MAAM,OAAO,QAAQ;IACnB,uDAAuD;IACvD,QAAQ,GAAG,GAAG,CAAC;IACP,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5B,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,6CAA6C;IAC7C,MAAM,GAAG,CAAC,CAAC;IACX,MAAM,GAAG,CAAC,CAAC;IACX,SAAS,GAAG,KAAK,CAAC;IAElB,IAAI;QACF,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtI,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;YAAE,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjH,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Gamepads, PAD_BUTTONS, type PadButton, type PadStick } from "./gamepad.js";
+export { type Binding, type Bindings, Input, type InputHost, type InputOptions } from "./input.js";
+export { Keyboard } from "./keyboard.js";
+export { Pointer, type ToLogical, type TouchPoint } from "./pointer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACnG,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { Gamepads, PAD_BUTTONS } from "./gamepad.js";
+export { Input } from "./input.js";
+export { Keyboard } from "./keyboard.js";
+export { Pointer } from "./pointer.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAiC,MAAM,cAAc,CAAC;AACpF,OAAO,EAA+B,KAAK,EAAqC,MAAM,YAAY,CAAC;AACnG,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAmC,MAAM,cAAc,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,62 @@
+import { Gamepads } from "./gamepad.js";
+import { Keyboard } from "./keyboard.js";
+import { Pointer, type ToLogical } from "./pointer.js";
+/**
+ * A binding is a source name:
+ * - a `KeyboardEvent.code`: `"Space"`, `"KeyZ"`, `"ArrowLeft"`
+ * - `"Pointer"`: primary mouse button / touch / pen
+ * - a gamepad button or stick direction: `"PadA"`, `"PadLeft"`, `"PadStickLeft"`
+ */
+export type Binding = string;
+export type Bindings<A extends string> = Record<A, readonly Binding[]>;
+/** The parts of `Game` that `Input` uses. */
+export interface InputHost {
+    canvas: HTMLElement;
+    toLogical: ToLogical;
+    hooks: {
+        afterUpdate(fn: (dt: number) => void): () => void;
+    };
+}
+export interface InputOptions<A extends string> {
+    /** Named actions and the sources that trigger them. */
+    bindings: Bindings<A>;
+    /** Element receiving keyboard events. Default `window`. */
+    keyboardTarget?: Window | HTMLElement;
+    /** Block the browser default for bound keys (page scrolling in embeds). Default true. */
+    captureKeys?: boolean;
+}
+/**
+ * Action-based input across keyboard, pointer and gamepad.
+ *
+ * ```ts
+ * const input = new Input(game, {
+ *   bindings: { left: ["ArrowLeft", "KeyA", "PadLeft"], jump: ["Space", "PadA", "Pointer"] },
+ * });
+ * if (input.pressed("jump")) jump();
+ * const dx = input.axis("left", "right");
+ * ```
+ *
+ * Edges are cleared automatically after each simulation step.
+ */
+export declare class Input<A extends string> {
+    readonly keys: Keyboard;
+    readonly pointer: Pointer;
+    readonly pads: Gamepads;
+    readonly bindings: Bindings<A>;
+    private readonly unhook;
+    constructor(host: InputHost, options: InputOptions<A>);
+    /** Any binding for the action is held. */
+    down(action: A): boolean;
+    /** The action started this step. */
+    pressed(action: A): boolean;
+    /** The action ended this step. */
+    released(action: A): boolean;
+    /** -1, 0 or 1 from two opposing actions, e.g. `axis("left", "right")`. */
+    axis(negative: A, positive: A): number;
+    dispose(): void;
+    private some;
+    private isPad;
+    /** Clear edges, then sample gamepads for the next step (the Gamepad API is poll-based). */
+    private endStep;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,CAAC,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC;AAEvE,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE;QAAE,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;KAAE,CAAC;CAC9D;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM;IAC5C,uDAAuD;IACvD,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACtC,yFAAyF;IACzF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,MAAM;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,WAAkB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IAEpC,YAAY,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAWpD;IAED,0CAA0C;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAEvB;IAED,oCAAoC;IACpC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAE1B;IAED,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAI3B;IAED,0EAA0E;IAC1E,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAErC;IAED,OAAO,IAAI,IAAI,CAId;IAED,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,KAAK;IAIb,2FAA2F;IAC3F,OAAO,CAAC,OAAO;CAKhB"}

package/dist/input.js

@@ -0,0 +1,74 @@
+import { Gamepads } from "./gamepad.js";
+import { Keyboard } from "./keyboard.js";
+import { Pointer } from "./pointer.js";
+/**
+ * Action-based input across keyboard, pointer and gamepad.
+ *
+ * ```ts
+ * const input = new Input(game, {
+ *   bindings: { left: ["ArrowLeft", "KeyA", "PadLeft"], jump: ["Space", "PadA", "Pointer"] },
+ * });
+ * if (input.pressed("jump")) jump();
+ * const dx = input.axis("left", "right");
+ * ```
+ *
+ * Edges are cleared automatically after each simulation step.
+ */
+export class Input {
+    keys;
+    pointer;
+    pads = new Gamepads();
+    bindings;
+    unhook;
+    constructor(host, options) {
+        this.bindings = options.bindings;
+        this.keys = new Keyboard(options.keyboardTarget ?? window);
+        if (options.captureKeys ?? true) {
+            for (const list of Object.values(options.bindings)) {
+                for (const b of list)
+                    if (b !== "Pointer" && !b.startsWith("Pad"))
+                        this.keys.captured.add(b);
+            }
+        }
+        // Call through the host so a class method keeps its `this`.
+        this.pointer = new Pointer(host.canvas, (x, y) => host.toLogical(x, y));
+        this.unhook = host.hooks.afterUpdate(() => this.endStep());
+    }
+    /** Any binding for the action is held. */
+    down(action) {
+        return this.some(action, (b) => (b === "Pointer" ? this.pointer.down : this.isPad(b) ? this.pads.down(b) : this.keys.down(b)));
+    }
+    /** The action started this step. */
+    pressed(action) {
+        return this.some(action, (b) => (b === "Pointer" ? this.pointer.pressed : this.isPad(b) ? this.pads.pressed(b) : this.keys.pressed(b)));
+    }
+    /** The action ended this step. */
+    released(action) {
+        return this.some(action, (b) => b === "Pointer" ? this.pointer.released : this.isPad(b) ? this.pads.released(b) : this.keys.released(b));
+    }
+    /** -1, 0 or 1 from two opposing actions, e.g. `axis("left", "right")`. */
+    axis(negative, positive) {
+        return (this.down(positive) ? 1 : 0) - (this.down(negative) ? 1 : 0);
+    }
+    dispose() {
+        this.unhook();
+        this.keys.dispose();
+        this.pointer.dispose();
+    }
+    some(action, test) {
+        const list = this.bindings[action];
+        if (!list)
+            throw new Error(`Unknown input action "${action}". Known: ${Object.keys(this.bindings).join(", ")}`);
+        return list.some(test);
+    }
+    isPad(b) {
+        return b.startsWith("Pad");
+    }
+    /** Clear edges, then sample gamepads for the next step (the Gamepad API is poll-based). */
+    endStep() {
+        this.keys.endStep();
+        this.pointer.endStep();
+        this.pads.poll();
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

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

package/dist/keyboard.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Keyboard state by `KeyboardEvent.code` (layout-independent, e.g. `"KeyW"`, `"ArrowLeft"`, `"Space"`).
+ *
+ * Edges (`pressed`/`released`) are latched until `endStep()`, so a tap shorter than a
+ * simulation step is never missed. `Input` calls `endStep()` for you.
+ */
+export declare class Keyboard {
+    private readonly held;
+    private readonly pressedEdge;
+    private readonly releasedEdge;
+    private readonly target;
+    /**
+     * Keys whose browser default (scrolling with arrows/Space, find-as-you-type…) is blocked so an
+     * embedded game doesn't move the page. Never applied while the user types in a form field.
+     */
+    readonly captured: Set<string>;
+    private readonly onDown;
+    private readonly onUp;
+    private readonly onBlur;
+    constructor(target?: Window | HTMLElement);
+    /** Key is currently held. */
+    down(code: string): boolean;
+    /** Key went down since the last step. */
+    pressed(code: string): boolean;
+    /** Key went up since the last step. */
+    released(code: string): boolean;
+    /** Simulate a key press (scenarios, tests, on-screen buttons). */
+    press(code: string): void;
+    /** Simulate a key release. */
+    release(code: string): void;
+    releaseAll(): void;
+    /** Clear edges. Call once after each simulation step. */
+    endStep(): void;
+    private shouldCapture;
+    dispose(): void;
+}
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,cAAqB;IAEtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAIrB;IACF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAInB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAElD,YAAY,MAAM,GAAE,MAAM,GAAG,WAAoB,EAKhD;IAED,6BAA6B;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1B;IAED,yCAAyC;IACzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7B;IAED,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED,kEAAkE;IAClE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIxB;IAED,8BAA8B;IAC9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG1B;IAED,UAAU,IAAI,IAAI,CAEjB;IAED,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,aAAa;IAOrB,OAAO,IAAI,IAAI,CAId;CACF"}

package/dist/keyboard.js

@@ -0,0 +1,84 @@
+/**
+ * Keyboard state by `KeyboardEvent.code` (layout-independent, e.g. `"KeyW"`, `"ArrowLeft"`, `"Space"`).
+ *
+ * Edges (`pressed`/`released`) are latched until `endStep()`, so a tap shorter than a
+ * simulation step is never missed. `Input` calls `endStep()` for you.
+ */
+export class Keyboard {
+    held = new Set();
+    pressedEdge = new Set();
+    releasedEdge = new Set();
+    target;
+    /**
+     * Keys whose browser default (scrolling with arrows/Space, find-as-you-type…) is blocked so an
+     * embedded game doesn't move the page. Never applied while the user types in a form field.
+     */
+    captured = new Set();
+    onDown = (e) => {
+        const k = e;
+        if (this.shouldCapture(k))
+            k.preventDefault();
+        if (!k.repeat)
+            this.press(k.code);
+    };
+    onUp = (e) => {
+        const k = e;
+        if (this.shouldCapture(k))
+            k.preventDefault();
+        this.release(k.code);
+    };
+    onBlur = () => this.releaseAll();
+    constructor(target = window) {
+        this.target = target;
+        target.addEventListener("keydown", this.onDown);
+        target.addEventListener("keyup", this.onUp);
+        window.addEventListener("blur", this.onBlur);
+    }
+    /** Key is currently held. */
+    down(code) {
+        return this.held.has(code);
+    }
+    /** Key went down since the last step. */
+    pressed(code) {
+        return this.pressedEdge.has(code);
+    }
+    /** Key went up since the last step. */
+    released(code) {
+        return this.releasedEdge.has(code);
+    }
+    /** Simulate a key press (scenarios, tests, on-screen buttons). */
+    press(code) {
+        if (this.held.has(code))
+            return;
+        this.held.add(code);
+        this.pressedEdge.add(code);
+    }
+    /** Simulate a key release. */
+    release(code) {
+        if (!this.held.delete(code))
+            return;
+        this.releasedEdge.add(code);
+    }
+    releaseAll() {
+        for (const code of [...this.held])
+            this.release(code);
+    }
+    /** Clear edges. Call once after each simulation step. */
+    endStep() {
+        this.pressedEdge.clear();
+        this.releasedEdge.clear();
+    }
+    shouldCapture(e) {
+        if (!this.captured.has(e.code) || e.ctrlKey || e.metaKey || e.altKey)
+            return false;
+        const t = e.target;
+        const editable = t && (t.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(t.tagName));
+        return !editable;
+    }
+    dispose() {
+        this.target.removeEventListener("keydown", this.onDown);
+        this.target.removeEventListener("keyup", this.onUp);
+        window.removeEventListener("blur", this.onBlur);
+    }
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/keyboard.js.map

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

package/dist/pointer.d.ts

@@ -0,0 +1,43 @@
+/** Maps client (event) coordinates to the game's logical coordinates. `Game.toLogical` fits. */
+export type ToLogical = (clientX: number, clientY: number) => {
+    x: number;
+    y: number;
+};
+export interface TouchPoint {
+    readonly id: number;
+    x: number;
+    y: number;
+}
+/**
+ * Unified mouse, touch and pen input via Pointer Events, in logical game coordinates.
+ *
+ * `x`, `y`, `down`, `pressed` and `released` describe the primary pointer. Edges are
+ * latched until `endStep()`. All active contacts are in `touches` for multi-touch.
+ */
+export declare class Pointer {
+    x: number;
+    y: number;
+    down: boolean;
+    pressed: boolean;
+    released: boolean;
+    /** Active contacts keyed by pointerId. */
+    readonly touches: Map<number, TouchPoint>;
+    private readonly element;
+    private readonly toLogical;
+    private readonly onDown;
+    private readonly onMove;
+    private readonly onContextMenu;
+    private readonly onUp;
+    constructor(element: HTMLElement, toLogical: ToLogical);
+    /** Simulate pressing the primary pointer at logical coordinates. */
+    press(x: number, y: number): void;
+    /** Simulate moving the primary pointer. */
+    move(x: number, y: number): void;
+    /** Simulate releasing the primary pointer. */
+    release(): void;
+    /** Clear edges. Call once after each simulation step. */
+    endStep(): void;
+    dispose(): void;
+    private track;
+}
+//# sourceMappingURL=pointer.d.ts.map

package/dist/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../src/pointer.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,CAAC,SAAK;IACN,CAAC,SAAK;IACN,IAAI,UAAS;IACb,OAAO,UAAS;IAChB,QAAQ,UAAS;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,0BAAiC;IAEjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAKrB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAGnB;IAEF,YAAY,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EASrD;IAED,oEAAoE;IACpE,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAMhC;IAED,2CAA2C;IAC3C,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAG/B;IAED,8CAA8C;IAC9C,OAAO,IAAI,IAAI,CAId;IAED,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,IAAI,IAAI,CAMd;IAED,OAAO,CAAC,KAAK;CAOd"}

package/dist/pointer.js

@@ -0,0 +1,88 @@
+/**
+ * Unified mouse, touch and pen input via Pointer Events, in logical game coordinates.
+ *
+ * `x`, `y`, `down`, `pressed` and `released` describe the primary pointer. Edges are
+ * latched until `endStep()`. All active contacts are in `touches` for multi-touch.
+ */
+export class Pointer {
+    x = 0;
+    y = 0;
+    down = false;
+    pressed = false;
+    released = false;
+    /** Active contacts keyed by pointerId. */
+    touches = new Map();
+    element;
+    toLogical;
+    onDown = (e) => {
+        this.element.setPointerCapture?.(e.pointerId);
+        const p = this.track(e);
+        if (e.isPrimary)
+            this.press(p.x, p.y);
+        e.preventDefault();
+    };
+    onMove = (e) => {
+        if (this.touches.has(e.pointerId) || e.isPrimary)
+            this.track(e);
+    };
+    // Right-click shouldn't open the browser menu over a game.
+    onContextMenu = (e) => e.preventDefault();
+    onUp = (e) => {
+        this.touches.delete(e.pointerId);
+        if (e.isPrimary)
+            this.release();
+    };
+    constructor(element, toLogical) {
+        this.element = element;
+        this.toLogical = toLogical;
+        element.style.touchAction = "none";
+        element.addEventListener("pointerdown", this.onDown);
+        element.addEventListener("pointermove", this.onMove);
+        element.addEventListener("pointerup", this.onUp);
+        element.addEventListener("pointercancel", this.onUp);
+        element.addEventListener("contextmenu", this.onContextMenu);
+    }
+    /** Simulate pressing the primary pointer at logical coordinates. */
+    press(x, y) {
+        this.x = x;
+        this.y = y;
+        if (this.down)
+            return;
+        this.down = true;
+        this.pressed = true;
+    }
+    /** Simulate moving the primary pointer. */
+    move(x, y) {
+        this.x = x;
+        this.y = y;
+    }
+    /** Simulate releasing the primary pointer. */
+    release() {
+        if (!this.down)
+            return;
+        this.down = false;
+        this.released = true;
+    }
+    /** Clear edges. Call once after each simulation step. */
+    endStep() {
+        this.pressed = false;
+        this.released = false;
+    }
+    dispose() {
+        this.element.removeEventListener("pointerdown", this.onDown);
+        this.element.removeEventListener("pointermove", this.onMove);
+        this.element.removeEventListener("pointerup", this.onUp);
+        this.element.removeEventListener("pointercancel", this.onUp);
+        this.element.removeEventListener("contextmenu", this.onContextMenu);
+    }
+    track(e) {
+        const { x, y } = this.toLogical(e.clientX, e.clientY);
+        const point = { id: e.pointerId, x, y };
+        if (e.buttons || e.type === "pointerdown")
+            this.touches.set(e.pointerId, point);
+        if (e.isPrimary)
+            this.move(x, y);
+        return point;
+    }
+}
+//# sourceMappingURL=pointer.js.map

package/dist/pointer.js.map

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

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@debuffjp/input",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Action-based keyboard, pointer and gamepad input for debuff",
+  "keywords": [
+    "game",
+    "gamedev",
+    "game-engine",
+    "2d",
+    "html5-game",
+    "browser-game",
+    "debuff",
+    "input",
+    "keyboard",
+    "gamepad",
+    "touch",
+    "pointer-events"
+  ],
+  "license": "MIT",
+  "homepage": "https://debuff.jp",
+  "bugs": "https://github.com/debuffjp/debuff/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/debuffjp/debuff.git",
+    "directory": "packages/input"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  }
+}