like2d 2.10.2 → 2.11.1

package/dist/input/gamepad-mapping.d.ts

@@ -1,12 +1,9 @@
 /**
- * @module GamepadMapping
- *
  * A database, generated on module load,
  * which uses SDL's database to coerce
  * browser APIs into physical gamepad button
  * mappings.
  *
- *
  * Browser API shortcomings:
  *  - [No standard way of exposing vendor/product, Safari doesn't even do it.](https://github.com/w3c/gamepad/issues/199)
  *  - Vendor and product alone doesn't suffice for GUID -- Different controllers have the same, it's good-enough.
@@ -19,13 +16,14 @@
  */
 import type { Vector2 } from "../math";
 /**
+ * @private
  * ref: https://www.w3.org/TR/gamepad/#dfn-standard-gamepad
  * note: `num` is only the corresponding number on standard mapping above.
  *
  * The point of the mapping system is to apply that _or_ non-standard mappings,
  * Which are exceedingly common.
  */
-declare const buttonMap: readonly [{
+export declare const buttonMap: readonly [{
     readonly like: "BBottom";
     readonly num: number;
     readonly name: "Bottom Face Button";
@@ -101,8 +99,10 @@ export type StickAxisMapping = {
     index: number;
     invert: boolean;
 };
+/** @private Get an empty mapping for a gamepad. Good for binding from scratch. */
 export declare const defaultMapping: (stickCount: number) => GamepadMapping;
 export declare const standardButtonMapping: () => ButtonMapping;
+/** @private */
 export declare const allButtons: Set<string>;
 export declare const fullButtonName: Map<"BBottom" | "BRight" | "BLeft" | "BTop" | "L1" | "R1" | "L2" | "R2" | "MenuLeft" | "MenuRight" | "LeftStick" | "RightStick" | "Up" | "Down" | "Left" | "Right", "Bottom Face Button" | "Right Face Button" | "Left Face Button" | "Top Face Button" | "Left shoulder (front)" | "Right shoulder (front)" | "Left shoulder (rear)" | "Right shoulder (rear)" | "Left Menu Button" | "Right Menu Button" | "Left Stick Button" | "Right Stick Button" | "D-Pad Up" | "D-Pad Down" | "D-Pad Left" | "D-Pad right">;
 export declare const mapStick: (gp: Gamepad, mapping: StickMapping) => Vector2;

package/dist/input/gamepad-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gamepad-mapping.d.ts","sourceRoot":"","sources":["../../src/input/gamepad-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;GAMG;AACH,QAAA,MAAM,SAAS;;kBACgB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB3B,CAAC;AAUX,MAAM,MAAM,UAAU,GAClB,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAClC,SAAS,MAAM,EAAE,GACjB,OAAO,MAAM,GAAG,GAChB,OAAO,MAAM,GAAG,CAAC;AAIrB,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,eAAO,MAAM,cAAc,GAAI,YAAY,MAAM,KAAG,cAQlD,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAAO,aAC0B,CAAC;AACpE,eAAO,MAAM,UAAU,aAAqD,CAAC;AAC7E,eAAO,MAAM,cAAc,qfAE1B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,IAAI,OAAO,EAAE,SAAS,YAAY,KAAG,OAK7D,CAAC;AAkBF,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAwBtE"}
+{"version":3,"file":"gamepad-mapping.d.ts","sourceRoot":"","sources":["../../src/input/gamepad-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;kBACS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB3B,CAAC;AAUX,MAAM,MAAM,UAAU,GAClB,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAClC,SAAS,MAAM,EAAE,GACjB,OAAO,MAAM,GAAG,GAChB,OAAO,MAAM,GAAG,CAAC;AAIrB,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,kFAAkF;AAClF,eAAO,MAAM,cAAc,GAAI,YAAY,MAAM,KAAG,cAQlD,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAAO,aAC0B,CAAC;AACpE,eAAe;AACf,eAAO,MAAM,UAAU,aAAqD,CAAC;AAC7E,eAAO,MAAM,cAAc,qfAE1B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,IAAI,OAAO,EAAE,SAAS,YAAY,KAAG,OAK7D,CAAC;AAkBF,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAwBtE"}

package/dist/input/gamepad-mapping.js

@@ -1,12 +1,9 @@
 /**
- * @module GamepadMapping
- *
  * A database, generated on module load,
  * which uses SDL's database to coerce
  * browser APIs into physical gamepad button
  * mappings.
  *
- *
  * Browser API shortcomings:
  *  - [No standard way of exposing vendor/product, Safari doesn't even do it.](https://github.com/w3c/gamepad/issues/199)
  *  - Vendor and product alone doesn't suffice for GUID -- Different controllers have the same, it's good-enough.
@@ -18,13 +15,14 @@
  *  - We go with best-match and always fall back on manual mapping.
  */
 /**
+ * @private
  * ref: https://www.w3.org/TR/gamepad/#dfn-standard-gamepad
  * note: `num` is only the corresponding number on standard mapping above.
  *
  * The point of the mapping system is to apply that _or_ non-standard mappings,
  * Which are exceedingly common.
  */
-const buttonMap = [
+export const buttonMap = [
     { like: "BBottom", num: 0, name: "Bottom Face Button" },
     { like: "BRight", num: 1, name: "Right Face Button" },
     { like: "BLeft", num: 2, name: "Left Face Button" },
@@ -49,6 +47,7 @@ const detectedOs = ((s) => [
     ["Win", "Windows"],
     ["Mac", "Mac OS X"],
 ].find(([ss]) => s.includes(ss))?.[1] ?? "Linux")(navigator.userAgent);
+/** @private Get an empty mapping for a gamepad. Good for binding from scratch. */
 export const defaultMapping = (stickCount) => ({
     buttons: {},
     sticks: Array(stickCount)
@@ -59,6 +58,7 @@ export const defaultMapping = (stickCount) => ({
     ]),
 });
 export const standardButtonMapping = () => Object.fromEntries(buttonMap.map(({ like, num }) => [num, like]));
+/** @private */
 export const allButtons = new Set(buttonMap.map(({ like }) => like));
 export const fullButtonName = new Map(buttonMap.map(({ like, name }) => [like, name]));
 export const mapStick = (gp, mapping) => {

package/dist/input/gamepad.d.ts

@@ -12,8 +12,18 @@ export type GamepadTarget = number | "any";
  *
  * If you're planning on supporting gamepads, please include a
  * way to generate {@link GamepadMapping} and set it with {@link Gamepad.setMapping}.
+ * Perhaps trigger it on {@link index.EventMap.gamepadconnected} events.
+ *
+ * If you don't want to make your own, take a look at {@link prefab-scenes.MapGamepad}
+ *
+ * ## When to use gamepad remapping
+ *
+ * For games with heavy and varied gamepad use, mapping buttons is essential.
+ *
+ * But if your game relies on a small set of logical actions like 'accept' or 'jump', don't hesitate to
+ * reach for {@link input} in order to map based on actions instead.
+ *
  *
- * If you don't want to make your own, take a look at `prefab-scenes/mapGamepad`.
  */
 export declare class Gamepad {
     private dispatch;

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

@@ -1 +1 @@
-{"version":3,"file":"gamepad.d.ts","sourceRoot":"","sources":["../../src/input/gamepad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,cAAc,EAAiB,UAAU,EAAmC,MAAM,mBAAmB,CAAC;AAC/I,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,gCAAgC;AAChC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,eAAe,CAAQ;gBAEnB,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC;IAmChD,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE;IAQpC,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIxC,OAAO,CAAC,WAAW;IAYnB,yCAAyC;IACzC,MAAM,CACJ,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,UAAU,GAAG,MAAM,GAC1B,OAAO,GAAG,SAAS;IAItB;;;OAGG;IACH,WAAW,CACT,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,UAAU,GAAG,MAAM,GAC1B,OAAO,GAAG,SAAS;IAItB;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIrD;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,UAAO;IAU9D;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAYtD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;IASlD;;;;;;;OAOG;IACH,qBAAqB,CAAC,MAAM,EAAE,OAAO;CAGtC"}
+{"version":3,"file":"gamepad.d.ts","sourceRoot":"","sources":["../../src/input/gamepad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,cAAc,EAAiB,UAAU,EAAmC,MAAM,mBAAmB,CAAC;AAC/I,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,gCAAgC;AAChC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,eAAe,CAAQ;gBAEnB,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC;IAmChD,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE;IAQpC,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIxC,OAAO,CAAC,WAAW;IAYnB,yCAAyC;IACzC,MAAM,CACJ,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,UAAU,GAAG,MAAM,GAC1B,OAAO,GAAG,SAAS;IAItB;;;OAGG;IACH,WAAW,CACT,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,UAAU,GAAG,MAAM,GAC1B,OAAO,GAAG,SAAS;IAItB;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIrD;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,UAAO;IAU9D;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAYtD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;IASlD;;;;;;;OAOG;IACH,qBAAqB,CAAC,MAAM,EAAE,OAAO;CAGtC"}

package/dist/input/gamepad.js

@@ -7,8 +7,18 @@ import { defaultMapping, fullButtonName, getSdlMapping, mapStick, standardButton
  *
  * If you're planning on supporting gamepads, please include a
  * way to generate {@link GamepadMapping} and set it with {@link Gamepad.setMapping}.
+ * Perhaps trigger it on {@link index.EventMap.gamepadconnected} events.
+ *
+ * If you don't want to make your own, take a look at {@link prefab-scenes.MapGamepad}
+ *
+ * ## When to use gamepad remapping
+ *
+ * For games with heavy and varied gamepad use, mapping buttons is essential.
+ *
+ * But if your game relies on a small set of logical actions like 'accept' or 'jump', don't hesitate to
+ * reach for {@link input} in order to map based on actions instead.
+ *
  *
- * If you don't want to make your own, take a look at `prefab-scenes/mapGamepad`.
  */
 export class Gamepad {
     constructor(props) {

package/dist/input/index.d.ts

@@ -1,6 +1,14 @@
-export type { Input, InputType, InputBinding, } from "./input";
-export type { GamepadTarget, Gamepad, } from "./gamepad";
-export type { LikeButton, GamepadMapping, StickMapping, StickAxisMapping, } from "./gamepad-mapping";
-export { defaultMapping, allButtons } from "./gamepad-mapping";
-export type { MouseSetMode, Mouse, } from "./mouse";
+/**
+ * Where {@link Keyboard}, {@link Mouse}, {@link Gamepad}, and actions in {@link Input} reside.
+ * @module input
+*/
+export type { Keyboard } from "./keyboard";
+export type { Mouse } from "./mouse";
+export type { Gamepad } from "./gamepad";
+export type { Input } from "./input";
+export type { MouseSetMode, MouseMode, MouseButton, } from "./mouse";
+export type { GamepadTarget, } from "./gamepad";
+export type { LikeButton, GamepadMapping, ButtonMapping, StickMapping, StickAxisMapping, } from "./gamepad-mapping";
+export type { InputType, InputBinding, } from "./input";
+export { defaultMapping, allButtons, buttonMap } from "./gamepad-mapping";
 //# sourceMappingURL=index.d.ts.map

package/dist/input/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/input/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,EACL,SAAS,EACT,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,aAAa,EACb,OAAO,GACR,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/D,YAAY,EACV,YAAY,EACZ,KAAK,GACN,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/input/index.ts"],"names":[],"mappings":"AAAA;;;EAGE;AAEF,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,aAAa,GACd,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,SAAS,EACT,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/input/index.js

@@ -1 +1,5 @@
-export { defaultMapping, allButtons } from "./gamepad-mapping";
+/**
+ * Where {@link Keyboard}, {@link Mouse}, {@link Gamepad}, and actions in {@link Input} reside.
+ * @module input
+*/
+export { defaultMapping, allButtons, buttonMap } from "./gamepad-mapping";

package/dist/input/input.d.ts

@@ -1,8 +1,9 @@
 import type { Keyboard } from './keyboard';
-import type { Mouse } from './mouse';
+import type { Mouse, MouseButton } from './mouse';
 import { Gamepad, GamepadTarget } from './gamepad';
 import { LikeButton } from './gamepad-mapping';
-import { MouseButton, Dispatcher } from '../events';
+import { LikeActionEvent } from '../events';
+import { EngineProps } from '../engine';
 export type InputType = InputBinding['type'];
 export type InputBinding = {
     type: 'keyboard';
@@ -15,15 +16,64 @@ export type InputBinding = {
     gamepad: GamepadTarget;
     button: LikeButton;
 };
+/**
+ * Used to map inputs (from keyboard, mouse, or gamepad) into actions.
+ *
+ * {@link setAction} allows for set-and-forget mappings. Good for one-off games.
+ *
+ * Example:
+ * ```js
+ * // bind action jump
+ * like.load() {
+ *   like.input.setAction('jump', ['KeyX', 'Space', 'ButtonBottom'])
+ * }
+ *
+ * like.actionpressed(action) {
+ *   if (action == 'jump') {
+ *     player.tryJumping();
+ *   }
+ * }
+ * ```
+ *
+ * For more sophisticated games, see also:
+ *  - {@link appendToAction}
+ *  - {@link getActionMapping}
+ *
+ * These allow for programmatic binding based on events. For example:
+ * ```js
+ * let currentlyMapping = 'jump';
+ *
+ * // Watch for gamepad and keyboard events
+ * like.keypressed = (code) => {
+ *   if (currentlyMapping) {
+ *     like.input.appendToAction(currentlyMapping, code);
+ *   }
+ * }
+ * like.gamepadpressed = (name) => {
+ *   if (currentlyMapping) {
+ *     like.input.appendToAction(currentlyMapping, name);
+ *   }
+ * }
+ *
+ * // Print some info about the current mapping
+ * like.draw = () => {
+ *   if (currentlyMapping) {
+ *     myGame.statusLine =
+ *       `Mapped ${like.input.getActionMapping(currentlyMapping)} to ${currentlyMapping}`
+ *   }
+ * }
+ *
+ * ```
+*/
 export declare class Input {
-    private dispatch;
     private currState;
     private prevState;
     private actionTable;
     private keyboard;
     private mouse;
     private gamepad;
-    constructor(dispatch: Dispatcher<'actionpressed' | 'actionreleased'>, deps: {
+    private dispatch;
+    constructor(props: EngineProps<LikeActionEvent>, deps: {
         keyboard: Keyboard;
         mouse: Mouse;
         gamepad: Gamepad;
@@ -42,6 +92,7 @@ export declare class Input {
      *    - Numeric: `Digit0`, `Digit1`, ...
      *    - `ArrowLeft`, `ArrowRight`, `ArrowUp`, `ArrowDown`
      *    - `ShiftLeft`, `ShiftRight`
+     *    - `Space`
      *    - `Minus`
      *    - `Equal` (also has a plus sign)
      *    - `BracketLeft` and `BracketRight`
@@ -70,7 +121,7 @@ export declare class Input {
     isDown(action: string): boolean;
     justPressed(action: string): boolean;
     justReleased(action: string): boolean;
-    update(): void;
+    private update;
     private isBindingActive;
 }
 //# sourceMappingURL=input.d.ts.map

package/dist/input/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/input/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAC7C,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAEpE,qBAAa,KAAK;IASd,OAAO,CAAC,QAAQ;IARlB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAU;gBAGf,QAAQ,EAAE,UAAU,CAAC,eAAe,GAAG,gBAAgB,CAAC,EAChE,IAAI,EAAE;QACJ,QAAQ,EAAE,QAAQ,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;KAClB;IAOH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAO,GAAG,IAAI;IAUvE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM;IAM3D;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAIhD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM/B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrC,MAAM;IAgBN,OAAO,CAAC,eAAe;CAaxB"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/input/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAc,eAAe,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAC7C,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgDE;AACF,qBAAa,KAAK;IAChB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAA6B;gBAG3C,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,IAAI,EAAE;QACJ,QAAQ,EAAE,QAAQ,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;KAClB;IAYH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAO,GAAG,IAAI;IAUvE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM;IAM3D;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAIhD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM/B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrC,OAAO,CAAC,MAAM;IAgBd,OAAO,CAAC,eAAe;CAaxB"}

package/dist/input/input.js

@@ -1,12 +1,55 @@
 import { allButtons } from './gamepad-mapping';
+/**
+ * Used to map inputs (from keyboard, mouse, or gamepad) into actions.
+ *
+ * {@link setAction} allows for set-and-forget mappings. Good for one-off games.
+ *
+ * Example:
+ * ```js
+ * // bind action jump
+ * like.load() {
+ *   like.input.setAction('jump', ['KeyX', 'Space', 'ButtonBottom'])
+ * }
+ *
+ * like.actionpressed(action) {
+ *   if (action == 'jump') {
+ *     player.tryJumping();
+ *   }
+ * }
+ * ```
+ *
+ * For more sophisticated games, see also:
+ *  - {@link appendToAction}
+ *  - {@link getActionMapping}
+ *
+ * These allow for programmatic binding based on events. For example:
+ * ```js
+ * let currentlyMapping = 'jump';
+ *
+ * // Watch for gamepad and keyboard events
+ * like.keypressed = (code) => {
+ *   if (currentlyMapping) {
+ *     like.input.appendToAction(currentlyMapping, code);
+ *   }
+ * }
+ * like.gamepadpressed = (name) => {
+ *   if (currentlyMapping) {
+ *     like.input.appendToAction(currentlyMapping, name);
+ *   }
+ * }
+ *
+ * // Print some info about the current mapping
+ * like.draw = () => {
+ *   if (currentlyMapping) {
+ *     myGame.statusLine =
+ *       `Mapped ${like.input.getActionMapping(currentlyMapping)} to ${currentlyMapping}`
+ *   }
+ * }
+ *
+ * ```
+*/
 export class Input {
-    constructor(dispatch, deps) {
-        Object.defineProperty(this, "dispatch", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: dispatch
-        });
+    constructor(props, deps) {
         Object.defineProperty(this, "currState", {
             enumerable: true,
             configurable: true,
@@ -43,9 +86,19 @@ export class Input {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "dispatch", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.keyboard = deps.keyboard;
         this.mouse = deps.mouse;
         this.gamepad = deps.gamepad;
+        this.dispatch = props.dispatch;
+        props.canvas.addEventListener("like:update", () => this.update(), {
+            signal: props.abort,
+        });
     }
     /**
      * This is the easiest way to set-and-forget input => action mapping.
@@ -61,6 +114,7 @@ export class Input {
      *    - Numeric: `Digit0`, `Digit1`, ...
      *    - `ArrowLeft`, `ArrowRight`, `ArrowUp`, `ArrowDown`
      *    - `ShiftLeft`, `ShiftRight`
+     *    - `Space`
      *    - `Minus`
      *    - `Equal` (also has a plus sign)
      *    - `BracketLeft` and `BracketRight`

package/dist/input/keyboard.d.ts

@@ -1,15 +1,38 @@
 import { EngineProps } from "../engine";
-type KEvent = 'keypressed' | 'keyreleased';
+import { type LikeKeyboardEvent } from "../events";
+/**
+ * A basic wrapper around keyboard.
+ *
+ * Keyboard uses scancodes by default, which are based on physical key
+ * positions rather than the logical (letter) meaning of the key.
+ *
+ * ## When to use Keyboard
+ *
+ * Using keyboard directly is discouraged, but of course allowed.
+ * Take a look at the actions system in {@link input} for a better solution.
+ *
+ * Also where there's text input such as `enter your name`, use the key code.
+ * This allows the user to use their intended keyboard layout.
+ *
+ * ```
+ * like.keypressed = (_code, key) => {
+ *   name += key;
+ * }
+ * ```
+ *
+ * Even if your game is heavily keyboard-reliant (like nethack), it is best to avoid mapping directly.
+ * Referring to action `drink` instead of code `KeyD` is also more programmer-ergonomic.
+ *
+ */
 export declare class Keyboard {
     private pressedScancodes;
     private canvas;
     private dispatch;
-    constructor(props: EngineProps<KEvent>);
+    constructor(props: EngineProps<LikeKeyboardEvent>);
     private handleKeyDown;
     private handleKeyUp;
     private handleBlur;
     isDown(scancode: string): boolean;
     isAnyDown(...scancodes: string[]): boolean;
 }
-export {};
 //# sourceMappingURL=keyboard.d.ts.map

package/dist/input/keyboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/input/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,KAAK,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC;AAE3C,qBAAa,QAAQ;IACnB,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC;IAUtC,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,UAAU;IAIlB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO;CAG3C"}
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/input/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAsC,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGvF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAgC;gBAEpC,KAAK,EAAE,WAAW,CAAC,iBAAiB,CAAC;IAUjD,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,UAAU;IAIlB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO;CAG3C"}

package/dist/input/keyboard.js

@@ -1,3 +1,27 @@
+/**
+ * A basic wrapper around keyboard.
+ *
+ * Keyboard uses scancodes by default, which are based on physical key
+ * positions rather than the logical (letter) meaning of the key.
+ *
+ * ## When to use Keyboard
+ *
+ * Using keyboard directly is discouraged, but of course allowed.
+ * Take a look at the actions system in {@link input} for a better solution.
+ *
+ * Also where there's text input such as `enter your name`, use the key code.
+ * This allows the user to use their intended keyboard layout.
+ *
+ * ```
+ * like.keypressed = (_code, key) => {
+ *   name += key;
+ * }
+ * ```
+ *
+ * Even if your game is heavily keyboard-reliant (like nethack), it is best to avoid mapping directly.
+ * Referring to action `drink` instead of code `KeyD` is also more programmer-ergonomic.
+ *
+ */
 export class Keyboard {
     constructor(props) {
         Object.defineProperty(this, "pressedScancodes", {

package/dist/input/mouse.d.ts

@@ -1,7 +1,8 @@
 import { type Vector2 } from '../math/vector2';
-import { type MouseButton, type LikeMouseEvent } from '../events';
+import { type LikeMouseEvent } from '../events';
 import { EngineProps } from '../engine';
-type MouseMode = {
+export type MouseButton = 'left' | 'middle' | 'right';
+export type MouseMode = {
     lock: false;
     visible: boolean;
     scrollBlock: boolean;
@@ -13,7 +14,35 @@ export type MouseSetMode = Partial<MouseMode> & {
     lock: boolean;
 };
 /**
- * Mouse input handling. Bound to canvas. Emits relative movement when pointer locked.
+ * LIKE's mouse wrapper.
+ *
+ * Mouse coordinates are scaled for convenience. For example call:
+ * ```
+ * like.canvas.setMode([240, 160])
+ * ```
+ * and your game will now be 240x160 pixels.
+ *
+ * Your mouse coords will stay within the rectangle `[0, 0]` and `[240, 160]`.
+ *
+ * If you intend to allow scrolling on your page while the mouse is above the game, use:
+ * ```
+ * like.mouse.setMode({ lock: false, scrollBlock: false })
+ * ```
+ *
+ * ### Capture
+ *
+ * Some games benefit from capture aka pointer lock. Call
+ * ```ts
+ * like.mouse.setMode({ lock: true, speed: 1 })
+ * ```
+ * to use capture, and now the mouse is locked to the game.
+ *
+ * When you enter capture, the mouse `pos` becomes virtual, bounded to canvas edges, plus controlled via the speed setting and teleport-able via {@link setCapturedPos}.
+ *
+ * When you exit capture, the mouse will be in the same spot the capture was started in.
+ *
+ * Note that your mode settings from non-capture mode are preserved in capture mode and vice-versa.
+ *
  */
 export declare class Mouse {
     private dispatch;
@@ -58,7 +87,7 @@ export declare class Mouse {
      * In locked mode, the cursor cannot escape the canvas.
      * It also becomes invisible.
      * However, it can move infinitely, sensitivity can be controlled,
-     * and the emulated cursor (in `pos` of {@link mousemoved}) can be freely repositioned.
+     * and the emulated cursor (in `pos` of {@link index.EventMap.mousemoved}) can be freely repositioned.
      *
      * ```ts
      * {
@@ -70,7 +99,7 @@ export declare class Mouse {
      * reset mode to default.
      *
      * ### Note on `pos` vs `delta`
-     * Event {@link mousemoved} passes both `pos` and `delta` args.
+     * Event {@link index.EventMap.mousemoved} passes both `pos` and `delta` args.
      *
      * Though the emulated cursor in locked mode
      * (locked mode doesn't natively track absolute position)
@@ -104,5 +133,4 @@ export declare class Mouse {
      */
     setRelativeMode?: never;
 }
-export {};
 //# sourceMappingURL=mouse.d.ts.map

package/dist/input/mouse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../src/input/mouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,KAAK,WAAW,EAAmB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAMxC,KAAK,SAAS,GACV;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE;;GAEG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAA0B;IACzC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,MAAM,CAAoB;IAIlC,OAAO,CAAC,UAAU,CAAsD;IACxE,OAAO,CAAC,YAAY,CAAgF;IACpG,OAAO,CAAC,UAAU,CAAS;gBAEf,KAAK,EAAE,WAAW,CAAC,cAAc,CAAC;IAwC9C,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IAMnB,oDAAoD;IACpD,WAAW,IAAI,OAAO;IAItB,uEAAuE;IACvE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAIpC,kCAAkC;IAClC,iBAAiB,IAAI,GAAG,CAAC,WAAW,CAAC;IAIrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY;IAgB1B,OAAO,IAAI,SAAS;IAIpB;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,OAAO;IAQ3B;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO;IAUzB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB"}
+{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../src/input/mouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAQtD,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAA0B;IACzC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,MAAM,CAAoB;IAIlC,OAAO,CAAC,UAAU,CAAsD;IACxE,OAAO,CAAC,YAAY,CAAgF;IACpG,OAAO,CAAC,UAAU,CAAS;gBAEf,KAAK,EAAE,WAAW,CAAC,cAAc,CAAC;IAwC9C,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IAMnB,oDAAoD;IACpD,WAAW,IAAI,OAAO;IAItB,uEAAuE;IACvE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAIpC,kCAAkC;IAClC,iBAAiB,IAAI,GAAG,CAAC,WAAW,CAAC;IAIrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY;IAgB1B,OAAO,IAAI,SAAS;IAIpB;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,OAAO;IAQ3B;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO;IAUzB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB"}

package/dist/input/mouse.js

@@ -2,7 +2,35 @@ import { Vec2 } from '../math/vector2';
 const mouseButtons = ["left", "middle", "right"];
 const numToButton = (i) => mouseButtons[i];
 /**
- * Mouse input handling. Bound to canvas. Emits relative movement when pointer locked.
+ * LIKE's mouse wrapper.
+ *
+ * Mouse coordinates are scaled for convenience. For example call:
+ * ```
+ * like.canvas.setMode([240, 160])
+ * ```
+ * and your game will now be 240x160 pixels.
+ *
+ * Your mouse coords will stay within the rectangle `[0, 0]` and `[240, 160]`.
+ *
+ * If you intend to allow scrolling on your page while the mouse is above the game, use:
+ * ```
+ * like.mouse.setMode({ lock: false, scrollBlock: false })
+ * ```
+ *
+ * ### Capture
+ *
+ * Some games benefit from capture aka pointer lock. Call
+ * ```ts
+ * like.mouse.setMode({ lock: true, speed: 1 })
+ * ```
+ * to use capture, and now the mouse is locked to the game.
+ *
+ * When you enter capture, the mouse `pos` becomes virtual, bounded to canvas edges, plus controlled via the speed setting and teleport-able via {@link setCapturedPos}.
+ *
+ * When you exit capture, the mouse will be in the same spot the capture was started in.
+ *
+ * Note that your mode settings from non-capture mode are preserved in capture mode and vice-versa.
+ *
  */
 export class Mouse {
     constructor(props) {
@@ -91,7 +119,8 @@ export class Mouse {
         this.canvas.addEventListener("mouseleave", () => this.buttons.clear(), {
             signal: abort,
         });
-        this.canvas.addEventListener("pointerlockchanged", () => {
+        this.canvas.addEventListener("pointerlockchange", // unsupported on mobile, will have to test.
+        () => {
             if (!this.isPointerLocked())
                 this.enableLock = false;
         }, { signal: abort });
@@ -160,7 +189,7 @@ export class Mouse {
      * In locked mode, the cursor cannot escape the canvas.
      * It also becomes invisible.
      * However, it can move infinitely, sensitivity can be controlled,
-     * and the emulated cursor (in `pos` of {@link mousemoved}) can be freely repositioned.
+     * and the emulated cursor (in `pos` of {@link index.EventMap.mousemoved}) can be freely repositioned.
      *
      * ```ts
      * {
@@ -172,7 +201,7 @@ export class Mouse {
      * reset mode to default.
      *
      * ### Note on `pos` vs `delta`
-     * Event {@link mousemoved} passes both `pos` and `delta` args.
+     * Event {@link index.EventMap.mousemoved} passes both `pos` and `delta` args.
      *
      * Though the emulated cursor in locked mode
      * (locked mode doesn't natively track absolute position)

package/dist/like.d.ts

@@ -1,7 +1,3 @@
-/**
- * @module like
- * @description A catalogue of subsystems
- */
 import type { Audio } from './audio/index';
 import type { Timer } from './timer/index';
 import type { Input } from './input/index';
@@ -9,12 +5,15 @@ import type { Keyboard } from './input/keyboard';
 import type { Mouse } from './input/mouse';
 import type { Gamepad } from './input/gamepad';
 import type { Canvas } from './graphics/canvas';
-import type { BoundGraphics } from './graphics/index';
+import type { Graphics } from './graphics/index';
 import { EventMap, EventType, LikeEvent } from './events';
 import { Scene } from './scene';
+/** @private */
 export type TopLevelEventHandler = (event: LikeEvent) => void;
-type Callback<K extends EventType> = (...args: EventMap[K]) => void;
-type Callbacks = {
+/** @private */
+export type Callback<K extends EventType> = (...args: EventMap[K]) => void;
+/** @private */
+export type Callbacks = {
     [K in EventType]?: Callback<K>;
 };
 /**
@@ -38,9 +37,11 @@ export type Like = Callbacks & {
     /** Get and set screen size, choosing between native and pixel perfect prescaling. Plus fullscreen control. */
     readonly canvas: Canvas;
     /** Graphics module: LOVE-style rendering, plus a pseudo-synchronous way to load images. */
-    gfx: BoundGraphics;
+    readonly gfx: Graphics;
     /** I think you meant to type `canvas`. */
     window?: never;
+    /** Shortened to `like.gfx`. */
+    graphics?: never;
     /**
      * Start the game loop. Call this only once.
      * @returns Promise that resolves when the engine is ready
@@ -76,5 +77,4 @@ export type Like = Callbacks & {
      */
     callOwnHandlers(event: LikeEvent): void;
 };
-export {};
 //# sourceMappingURL=like.d.ts.map

package/dist/like.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"like.d.ts","sourceRoot":"","sources":["../src/like.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE9D,KAAK,QAAQ,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAEpE,KAAK,SAAS,GAAG;KACd,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG;IAC7B,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8GAA8G;IAC9G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,GAAG,EAAE,aAAa,CAAC;IAEnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,KAAK,CAAC;IAEf;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAE9B;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;IAEnC;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACzC,CAAA"}
+{"version":3,"file":"like.d.ts","sourceRoot":"","sources":["../src/like.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,eAAe;AACf,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE9D,eAAe;AACf,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE3E,eAAe;AACf,MAAM,MAAM,SAAS,GAAG;KACrB,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG;IAC7B,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8GAA8G;IAC9G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IAEvB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAE9B;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;IAEnC;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACzC,CAAA"}