like2d 2.7.4 → 2.9.0

package/dist/core/input.js

@@ -1,16 +1,6 @@
+import { GamepadInternal } from './gamepad';
 import { InputStateTracker } from './input-state';
-import { GP_NAME_MAP } from './gamepad-buttons';
-const buttonMap = {
-    'Left': 1,
-    'Right': 3,
-    'Middle': 2,
-    '1': 1,
-    '2': 2,
-    '3': 3,
-    '4': 4,
-    '5': 5,
-};
-export class Input {
+export class InputInternal {
     constructor(deps) {
         Object.defineProperty(this, "actionMap", {
             enumerable: true,
@@ -46,13 +36,16 @@ export class Input {
         this.mouse = deps.mouse;
         this.gamepad = deps.gamepad;
     }
-    map(action, inputs) {
-        const bindings = inputs.map(input => this.parseInput(input));
-        this.actionMap.set(action, bindings);
-    }
-    unmap(action) {
-        this.actionMap.delete(action);
-        this.actionStateTracker.clear();
+    setAction(action, inputs = []) {
+        if (inputs.length) {
+            const bindings = inputs.map(input => this.parseInput(input));
+            this.actionMap.set(action, bindings);
+        }
+        else {
+            this.actionMap.delete(action);
+            this.actionStateTracker.currState.delete(action);
+            this.actionStateTracker.prevState.delete(action);
+        }
     }
     isDown(action) {
         const bindings = this.actionMap.get(action);
@@ -66,8 +59,8 @@ export class Input {
     justReleased(action) {
         return this.actionStateTracker.justReleased(action);
     }
-    update() {
-        this.gamepad.update();
+    _update() {
+        this.gamepad._update();
         const activeActions = new Set();
         for (const [action] of this.actionMap) {
             if (this.isDown(action)) {
@@ -81,30 +74,25 @@ export class Input {
         const normalized = input.trim();
         if (normalized.startsWith('Mouse')) {
             const buttonCode = normalized.replace('Mouse', '');
-            return { type: 'mouse', code: buttonCode };
+            return { type: 'mouse', button: buttonCode };
         }
         if (normalized.startsWith('Button') || normalized.startsWith('DP')) {
-            return { type: 'gamepad', code: normalized };
+            return {
+                type: "gamepad",
+                gamepad: 0,
+                button: GamepadInternal.getButtonNumber(normalized),
+            };
         }
-        return { type: 'keyboard', code: normalized };
+        return { type: 'keyboard', scancode: normalized };
     }
     isBindingActive(binding) {
         switch (binding.type) {
             case 'keyboard':
-                return this.keyboard.isDown(binding.code);
-            case 'mouse': {
-                const button = buttonMap[binding.code];
-                if (button !== undefined) {
-                    return this.mouse.isDown(button);
-                }
-                return false;
-            }
+                return this.keyboard.isDown(binding.scancode);
+            case 'mouse':
+                return this.mouse.isDown(binding.button);
             case 'gamepad': {
-                const buttonIndex = GP_NAME_MAP[binding.code];
-                if (buttonIndex !== undefined) {
-                    return this.gamepad.isButtonDownOnAny(buttonIndex);
-                }
-                return false;
+                return !!this.gamepad.isButtonDown(binding.gamepad, binding.button);
             }
             default:
                 return false;

package/dist/core/keyboard.d.ts

@@ -1,14 +1,14 @@
-export declare class Keyboard {
+import { EngineDispatch } from "../engine";
+export declare class KeyboardInternal {
+    private dispatch;
     private pressedScancodes;
-    onKeyEvent?: (scancode: string, keycode: string, type: 'keydown' | 'keyup') => void;
-    private keydownHandler;
-    private keyupHandler;
-    private blurHandler;
-    constructor();
+    private canvas;
+    private abort;
+    constructor(canvas: HTMLCanvasElement | null, dispatch: EngineDispatch);
     private handleKeyDown;
     private handleKeyUp;
     private handleBlur;
-    dispose(): void;
+    _dispose(): void;
     isDown(scancode: string): boolean;
     isAnyDown(...scancodes: string[]): boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/core/keyboard.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ;IACnB,OAAO,CAAC,gBAAgB,CAAqB;IACtC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC;IAG3F,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,WAAW,CAAa;;IAchC,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,UAAU;IAIlB,OAAO,IAAI,IAAI;IAOf,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/core/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,qBAAa,gBAAgB;IAKmB,OAAO,CAAC,QAAQ;IAJ9D,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,KAAK,CAAyB;gBAE1B,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAAU,QAAQ,EAAE,cAAc;IAU9E,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,UAAU;IAIlB,QAAQ,IAAI,IAAI;IAKhB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO;CAG3C"}

package/dist/core/keyboard.js

@@ -1,64 +1,57 @@
-export class Keyboard {
-    constructor() {
-        Object.defineProperty(this, "pressedScancodes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Set()
-        });
-        Object.defineProperty(this, "onKeyEvent", {
+export class KeyboardInternal {
+    constructor(canvas, dispatch) {
+        Object.defineProperty(this, "dispatch", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: dispatch
         });
-        // Event handler references for cleanup
-        Object.defineProperty(this, "keydownHandler", {
+        Object.defineProperty(this, "pressedScancodes", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: new Set()
         });
-        Object.defineProperty(this, "keyupHandler", {
+        Object.defineProperty(this, "canvas", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: null
         });
-        Object.defineProperty(this, "blurHandler", {
+        Object.defineProperty(this, "abort", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: new AbortController()
         });
-        // Bind event handlers
-        this.keydownHandler = this.handleKeyDown.bind(this);
-        this.keyupHandler = this.handleKeyUp.bind(this);
-        this.blurHandler = this.handleBlur.bind(this);
-        // Register event listeners
-        window.addEventListener('keydown', this.keydownHandler);
-        window.addEventListener('keyup', this.keyupHandler);
-        window.addEventListener('blur', this.blurHandler);
+        this.canvas = canvas;
+        if (this.canvas) {
+            this.canvas.addEventListener('keydown', this.handleKeyDown.bind(this), { signal: this.abort.signal });
+            this.canvas.addEventListener('keyup', this.handleKeyUp.bind(this), { signal: this.abort.signal });
+            this.canvas.addEventListener('blur', this.handleBlur.bind(this), { signal: this.abort.signal });
+        }
     }
     handleKeyDown(e) {
+        const scrollKeys = ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Space', 'PageUp', 'PageDown', 'Home', 'End'];
+        if (scrollKeys.includes(e.code)) {
+            e.preventDefault();
+        }
         if (e.code) {
             this.pressedScancodes.add(e.code);
         }
-        this.onKeyEvent?.(e.code, e.key, 'keydown');
+        this.dispatch('keypressed', [e.code, e.key]);
     }
     handleKeyUp(e) {
         if (e.code) {
             this.pressedScancodes.delete(e.code);
         }
-        this.onKeyEvent?.(e.code, e.key, 'keyup');
+        this.dispatch('keyreleased', [e.code, e.key]);
     }
     handleBlur() {
         this.pressedScancodes.clear();
     }
-    dispose() {
-        window.removeEventListener('keydown', this.keydownHandler);
-        window.removeEventListener('keyup', this.keyupHandler);
-        window.removeEventListener('blur', this.blurHandler);
+    _dispose() {
+        this.abort.abort();
         this.pressedScancodes.clear();
     }
     isDown(scancode) {

package/dist/core/like.d.ts

@@ -1,23 +1,100 @@
-import type { Audio } from './audio';
-import type { Timer } from './timer';
-import type { Input } from './input';
-import type { Keyboard } from './keyboard';
-import type { Mouse } from './mouse';
-import type { Gamepad } from './gamepad';
-import type { Vector2 } from './vector2';
-import type { CanvasMode, PartialCanvasMode } from './canvas-config';
+/**
+ * @module like
+ * @description A catalogue of subsystems
+ *
+ * This is how we know what's part of like.
+ * `like.gfx`, `like.canvas`, and such.
+ *
+ */
+import type { AudioInternal } from './audio';
+import type { TimerInternal } from './timer';
+import type { InputInternal } from './input';
+import type { KeyboardInternal } from './keyboard';
+import type { MouseInternal } from './mouse';
+import type { GamepadInternal } from './gamepad';
+import type { CanvasInternal } from './canvas';
 import type { BoundGraphics } from './graphics';
-import type { Scene } from '../scene';
+import { EventMap, EventType, LikeEvent } from './events';
+import { TopLevelEventHandler } from '..';
+import { Scene } from '../scene';
+type Callback<K extends EventType> = (...args: EventMap[K]) => void;
+type Callbacks = {
+    [K in EventType]?: Callback<K>;
+};
+export type LikeInternal = Callbacks & {
+    readonly audio: AudioInternal;
+    readonly timer: TimerInternal;
+    readonly input: InputInternal;
+    readonly keyboard: KeyboardInternal;
+    readonly mouse: MouseInternal;
+    readonly gamepad: GamepadInternal;
+    canvas: CanvasInternal;
+    /** Graphics context for rendering operations */
+    gfx: BoundGraphics;
+    /**
+     * Start the game loop. Call this only once.
+     * @returns Promise that resolves when the engine is ready
+     */
+    start(): Promise<void>;
+    /**
+     * Clears out event listeners to avoid memory leaks.
+     */
+    dispose(): void;
+    /**
+     * A simple way to set the current scene, which acts like a pluggable
+     * set of callbacks.
+     *
+     * Translates into `like.handleEvent = (event) => sceneDispatch(scene, like, event)`
+     * followed by dispatching a `load` event.
+     *
+     * {@link Scene} for detailed usage.
+     * @param scene Scene to load, leave out to use callbacks.
+     */
+    setScene(scene?: Scene): void;
+    /**
+     * LIKE's runtime is built around calling handleEvent.
+     *
+     * For more advanced LIKE users, overriding this function allows you
+     * to create your own fundamental systems by writing an {@link TopLevelEventHandler}
+     *
+     * The built-in event handler amounts to calling `like[ev.type](...ev.args)`, as
+     * does the scene one which is a bit more like `yourScene[ev.type](like, ...ev.args)`.
+     *
+     * The code for them is very short and simple. Take a look if you're interested
+     * in building your own.
+     */
+    handleEvent?: TopLevelEventHandler;
+    callOwnHandlers(event: LikeEvent): void;
+};
 /**
- * The Like interface provides access to all core systems and APIs
- * that are passed to game callbacks (load, update, draw, etc.).
+ * A little helper that hides methods with underscores.
+ */
+type Public<T> = {
+    [K in keyof T as K extends `_${string}` ? never : K]: T[K];
+};
+type Canvas = Public<CanvasInternal>;
+type Keyboard = Public<KeyboardInternal>;
+type Mouse = Public<MouseInternal>;
+type Audio = Public<AudioInternal>;
+type Timer = Public<TimerInternal>;
+type Input = Public<InputInternal>;
+type Gamepad = Public<GamepadInternal>;
+/**
+ * The main Like instance.
+ * Use this object much how you would the `love` object in Love2D.
+ * This is the interface returned by {@link createLike}.
+ *
+ * Assigns callbacks to handle events. See {@link EventMap} for all available events.
  *
- * This is the main interface for interacting with the engine's subsystems.
+ * Don't forget to call `await start()` when you're ready,
+ * and `dispose()` if you're done with it.
  */
-export interface Like {
-    /** Audio system for managing and playing sounds */
+export type Like = LikeInternal & {
+    /** Canvas settings, including even Pixel Art mode. */
+    readonly canvas: Canvas;
+    /** Synchronous audio handles with global control. */
     readonly audio: Audio;
-    /** Timer system for tracking time, delta, and FPS */
+    /** Timer system for tracking time, delta, FPS, and freezing the whole game. */
     readonly timer: Timer;
     /** Input system for action-based input handling */
     readonly input: Input;
@@ -27,33 +104,10 @@ export interface Like {
     readonly mouse: Mouse;
     /** Gamepad input handling */
     readonly gamepad: Gamepad;
-    /** Graphics context for rendering operations */
-    readonly gfx: BoundGraphics;
-    /**
-     * Set the canvas display mode.
-     * @param mode - Partial canvas mode configuration
-     */
-    setMode(mode: PartialCanvasMode): void;
-    /**
-     * Get the current canvas mode configuration.
-     * @returns The current canvas mode or undefined if not available
-     */
-    getMode(): CanvasMode | undefined;
-    /**
-     * Get the current canvas size in pixels.
-     * @returns The canvas size as a Vector2 [width, height]
-     */
-    getCanvasSize(): Vector2;
-    /**
-     * Set the active scene. Pass null to revert to global callbacks.
-     */
-    setScene(scene: Scene | null): void;
-}
-export type { Audio, Source, SourceOptions } from './audio';
-export type { Timer } from './timer';
-export type { Input, InputBinding, InputType } from './input';
-export type { Keyboard } from './keyboard';
-export type { Mouse, MousePositionTransform } from './mouse';
-export type { Gamepad, StickPosition, ButtonCallback } from './gamepad';
-export type { CanvasMode, PartialCanvasMode } from './canvas-config';
+    /** Look at {@link handleEvent} -- it serves the same purpose. */
+    run?: never;
+    /** I think you meant to type like.canvas instead.  */
+    window?: never;
+};
+export {};
 //# sourceMappingURL=like.d.ts.map

package/dist/core/like.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"like.d.ts","sourceRoot":"","sources":["../../src/core/like.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,IAAI;IACnB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAE5B;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEvC;;;OAGG;IACH,OAAO,IAAI,UAAU,GAAG,SAAS,CAAC;IAElC;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;CACrC;AAGD,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5D,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC7D,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"like.d.ts","sourceRoot":"","sources":["../../src/core/like.ts"],"names":[],"mappings":"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"}

package/dist/core/like.js

@@ -1 +1,9 @@
+/**
+ * @module like
+ * @description A catalogue of subsystems
+ *
+ * This is how we know what's part of like.
+ * `like.gfx`, `like.canvas`, and such.
+ *
+ */
 export {};

package/dist/core/mouse.d.ts

@@ -1,29 +1,52 @@
-import type { Vector2 } from './vector2';
-export type MousePositionTransform = (cssX: number, cssY: number) => Vector2;
-export declare class Mouse {
-    private x;
-    private y;
+import { EngineDispatch } from '../engine';
+import { type Vector2 } from '../math/vector2';
+import { type MouseButton } from './events';
+/**
+ * Mouse input handling. Bound to canvas. Emits relative movement when pointer locked.
+ * Buttons: 1 = left, 2 = middle, 3 = right.
+ */
+export declare class MouseInternal {
+    private canvas;
+    private dispatch;
+    private pos;
+    private lastPos;
     private buttons;
-    onMouseEvent?: (clientX: number, clientY: number, button: number | undefined, type: 'mousemove' | 'mousedown' | 'mouseup') => void;
-    private transformFn?;
-    private mousemoveHandler;
-    private mousedownHandler;
-    private mouseupHandler;
-    private blurHandler;
-    constructor(transformFn?: MousePositionTransform);
-    setTransform(transformFn: MousePositionTransform | undefined): void;
+    private cursorVisible;
+    private abort;
+    constructor(canvas: HTMLCanvasElement, dispatch: EngineDispatch);
     private handleMouseMove;
     private handleMouseDown;
     private handleMouseUp;
-    private handleBlur;
-    dispose(): void;
+    private handleWheel;
+    _dispose(): void;
+    /** Mouse position, transformed to canvas pixels. */
     getPosition(): Vector2;
-    getX(): number;
-    getY(): number;
-    isDown(button: number): boolean;
-    getPressedButtons(): Set<number>;
-    isVisible(): boolean;
-    setVisible(visible: boolean, canvas?: HTMLCanvasElement): void;
-    getRelativeMode(): boolean;
+    /** Check if button is held. Button 1 = left, 2 = middle, 3 = right. */
+    isDown(button: MouseButton): boolean;
+    /** All currently held buttons. */
+    getPressedButtons(): Set<MouseButton>;
+    /** True when pointer is locked to canvas.
+     * {@link lockPointer}
+     */
+    isPointerLocked(): boolean;
+    /**
+     * Whether to lock (capture) the pointer.
+     *
+     * In locked mode, the cursor cannot escape the canvas.
+     * It also becomes invisible.
+     *
+     * Note that event {@link mousemoved} passes both
+     * `pos` and `delta`.
+     *
+     * Though the emulated cursor in locked mode
+     * (locked mode doesn't natively track absolute position)
+     * may be stuck on canvas edges, the `delta` field always
+     * represents mouse movement.
+    */
+    lockPointer(locked: boolean): void;
+    /** Show or hide cursor. Unlike pointer lock, cursor can still leave canvas. */
+    showCursor(visible: boolean): void;
+    /** Current cursor visibility state. */
+    isCursorVisible(): boolean;
 }
 //# sourceMappingURL=mouse.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../src/core/mouse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAE7E,qBAAa,KAAK;IAChB,OAAO,CAAC,CAAC,CAAK;IACd,OAAO,CAAC,CAAC,CAAK;IACd,OAAO,CAAC,OAAO,CAAqB;IAC7B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,KAAK,IAAI,CAAC;IAC1I,OAAO,CAAC,WAAW,CAAC,CAAyB;IAG7C,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,WAAW,CAAa;gBAEpB,WAAW,CAAC,EAAE,sBAAsB;IAgBhD,YAAY,CAAC,WAAW,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI;IAInE,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,UAAU;IAIlB,OAAO,IAAI,IAAI;IAQf,WAAW,IAAI,OAAO;IAOtB,IAAI,IAAI,MAAM;IAId,IAAI,IAAI,MAAM;IAId,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI/B,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC;IAIhC,SAAS,IAAI,OAAO;IAIpB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAQ9D,eAAe,IAAI,OAAO;CAG3B"}
+{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../src/core/mouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAM5C;;;GAGG;AACH,qBAAa,aAAa;IAOZ,OAAO,CAAC,MAAM;IAAqB,OAAO,CAAC,QAAQ;IAN/D,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,KAAK,CAAyB;gBAElB,MAAM,EAAE,iBAAiB,EAAU,QAAQ,EAAE,cAAc;IAQ/E,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IAInB,QAAQ,IAAI,IAAI;IAIhB,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;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;;;;;;;;;;MAaE;IACF,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAUlC,+EAA+E;IAC/E,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOlC,uCAAuC;IACvC,eAAe,IAAI,OAAO;CAG3B"}