@sadhaka/loom-engine 0.10.0

package/dist/input/input-manager.js

@@ -0,0 +1,349 @@
+// InputManager - DOM event listener that accumulates input state
+// between ticks. Read by InputSystem in PHASE_INPUT, which promotes
+// the accumulator to a frame-coherent InputResource that other
+// systems read.
+//
+// What it tracks:
+//   - Keyboard: keys held (Set<string>), keys pressed this frame
+//     (transitioned up->down between last beginFrame and this one),
+//     keys released this frame
+//   - Pointer: position in canvas-relative coordinates, button state,
+//     pressed-this-frame, released-this-frame
+//   - Touches: an array of active touch points (id, x, y)
+//
+// Frame-coherence model:
+//   Per-frame transient state (pressedThisFrame / releasedThisFrame /
+//   wheelDeltaThisFrame) accumulates DOM events between calls to
+//   beginFrame(). beginFrame() snapshots the transient state into
+//   "current frame" buffers and clears the accumulators for the next
+//   tick. Held / position / buttons remain continuous.
+//
+// Browsers fire DOM events asynchronously. RAF gives one tick per
+// vsync; multiple events can fire between ticks. Callers must call
+// beginFrame() once per frame (the InputSystem does this in
+// PHASE_INPUT, the very first phase, so all other systems read
+// stable state for the rest of the tick).
+export class InputManager {
+    keysHeld = new Set();
+    keysPressedAccum = new Set();
+    keysReleasedAccum = new Set();
+    pointer = { x: 0, y: 0, buttons: 0, inside: false };
+    pointerPressedAccum = 0;
+    pointerReleasedAccum = 0;
+    wheelDeltaAccum = 0;
+    activeTouches = new Map();
+    touchesStartedAccum = [];
+    touchesEndedAccum = [];
+    // Per-frame buffers (snapshot at beginFrame).
+    currentKeysPressed = new Set();
+    currentKeysReleased = new Set();
+    currentPointerPressed = 0;
+    currentPointerReleased = 0;
+    currentWheelDelta = 0;
+    currentTouchesStarted = [];
+    currentTouchesEnded = [];
+    // Phase 9.1: cached snapshot + cached touches array, mutated in
+    // place each frame so RESOURCE_INPUT readers don't trigger an
+    // allocation per tick. The fields below alias the manager's own
+    // collections; the snapshot's identity is stable across frames.
+    cachedTouchesArray = [];
+    cachedSnapshot;
+    // Bound listener refs so dispose() can detach them cleanly.
+    boundKeyDown = this.onKeyDown.bind(this);
+    boundKeyUp = this.onKeyUp.bind(this);
+    boundPointerMove = this.onPointerMove.bind(this);
+    boundPointerDown = this.onPointerDown.bind(this);
+    boundPointerUp = this.onPointerUp.bind(this);
+    boundPointerEnter = this.onPointerEnter.bind(this);
+    boundPointerLeave = this.onPointerLeave.bind(this);
+    boundWheel = this.onWheel.bind(this);
+    boundTouchStart = this.onTouchStart.bind(this);
+    boundTouchMove = this.onTouchMove.bind(this);
+    boundTouchEnd = this.onTouchEnd.bind(this);
+    boundTouchCancel = this.onTouchCancel.bind(this);
+    boundContextMenu = this.onContextMenu.bind(this);
+    canvas = null;
+    targetWindow = null;
+    attached = false;
+    constructor() {
+        // Build a stable cached snapshot once. snapshot() returns this
+        // same reference each frame, having mutated only the fields that
+        // change. Phase 9.1 alloc-churn fix.
+        this.cachedSnapshot = {
+            keysHeld: this.keysHeld,
+            keysPressedThisFrame: this.currentKeysPressed,
+            keysReleasedThisFrame: this.currentKeysReleased,
+            pointer: this.pointer,
+            pointerPressedThisFrame: 0,
+            pointerReleasedThisFrame: 0,
+            wheelDeltaThisFrame: 0,
+            touches: this.cachedTouchesArray,
+            touchesStartedThisFrame: this.currentTouchesStarted,
+            touchesEndedThisFrame: this.currentTouchesEnded,
+        };
+    }
+    // Attach DOM listeners. Keyboard goes on window so the canvas
+    // doesn't need focus to receive arrow keys. Pointer + wheel go on
+    // the canvas so coordinates resolve cleanly.
+    attach(canvas, win = window) {
+        if (this.attached)
+            return;
+        this.canvas = canvas;
+        this.targetWindow = win;
+        win.addEventListener('keydown', this.boundKeyDown);
+        win.addEventListener('keyup', this.boundKeyUp);
+        canvas.addEventListener('mousemove', this.boundPointerMove);
+        canvas.addEventListener('mousedown', this.boundPointerDown);
+        canvas.addEventListener('mouseup', this.boundPointerUp);
+        canvas.addEventListener('mouseenter', this.boundPointerEnter);
+        canvas.addEventListener('mouseleave', this.boundPointerLeave);
+        canvas.addEventListener('wheel', this.boundWheel, { passive: false });
+        canvas.addEventListener('touchstart', this.boundTouchStart, { passive: false });
+        canvas.addEventListener('touchmove', this.boundTouchMove, { passive: false });
+        canvas.addEventListener('touchend', this.boundTouchEnd);
+        canvas.addEventListener('touchcancel', this.boundTouchCancel);
+        canvas.addEventListener('contextmenu', this.boundContextMenu);
+        this.attached = true;
+    }
+    detach() {
+        if (!this.attached)
+            return;
+        const c = this.canvas;
+        const w = this.targetWindow;
+        if (w) {
+            w.removeEventListener('keydown', this.boundKeyDown);
+            w.removeEventListener('keyup', this.boundKeyUp);
+        }
+        if (c) {
+            c.removeEventListener('mousemove', this.boundPointerMove);
+            c.removeEventListener('mousedown', this.boundPointerDown);
+            c.removeEventListener('mouseup', this.boundPointerUp);
+            c.removeEventListener('mouseenter', this.boundPointerEnter);
+            c.removeEventListener('mouseleave', this.boundPointerLeave);
+            c.removeEventListener('wheel', this.boundWheel);
+            c.removeEventListener('touchstart', this.boundTouchStart);
+            c.removeEventListener('touchmove', this.boundTouchMove);
+            c.removeEventListener('touchend', this.boundTouchEnd);
+            c.removeEventListener('touchcancel', this.boundTouchCancel);
+            c.removeEventListener('contextmenu', this.boundContextMenu);
+        }
+        this.canvas = null;
+        this.targetWindow = null;
+        this.attached = false;
+    }
+    // Promote accumulated state to per-frame buffers and reset
+    // accumulators. Called once per tick by InputSystem in PHASE_INPUT.
+    //
+    // Phase 9.1 alloc-churn fix: ping-pong the accumulator/current pair
+    // and clear in place rather than allocating fresh Sets and arrays
+    // each tick. The snapshot's identity is stable across frames; only
+    // its contained collections change. Consumers must not retain a
+    // reference across frames (documented at the top of this module).
+    beginFrame() {
+        // Swap accumulator <-> current. After the swap, the old "current"
+        // (which is now the accumulator) gets cleared in place to be the
+        // collection for the next tick's events.
+        const swapPressed = this.currentKeysPressed;
+        this.currentKeysPressed = this.keysPressedAccum;
+        this.keysPressedAccum = swapPressed;
+        swapPressed.clear();
+        const swapReleased = this.currentKeysReleased;
+        this.currentKeysReleased = this.keysReleasedAccum;
+        this.keysReleasedAccum = swapReleased;
+        swapReleased.clear();
+        this.currentPointerPressed = this.pointerPressedAccum;
+        this.currentPointerReleased = this.pointerReleasedAccum;
+        this.currentWheelDelta = this.wheelDeltaAccum;
+        this.pointerPressedAccum = 0;
+        this.pointerReleasedAccum = 0;
+        this.wheelDeltaAccum = 0;
+        const swapStarted = this.currentTouchesStarted;
+        this.currentTouchesStarted = this.touchesStartedAccum;
+        this.touchesStartedAccum = swapStarted;
+        swapStarted.length = 0;
+        const swapEnded = this.currentTouchesEnded;
+        this.currentTouchesEnded = this.touchesEndedAccum;
+        this.touchesEndedAccum = swapEnded;
+        swapEnded.length = 0;
+    }
+    // Build the immutable snapshot that systems read. Phase 9.1: returns
+    // a cached snapshot object, mutating only the fields that change so
+    // RESOURCE_INPUT updates are zero-alloc per frame. The touches array
+    // is rebuilt in place into the cached array (no Array.from).
+    snapshot() {
+        const snap = this.cachedSnapshot;
+        snap.keysPressedThisFrame = this.currentKeysPressed;
+        snap.keysReleasedThisFrame = this.currentKeysReleased;
+        snap.pointerPressedThisFrame = this.currentPointerPressed;
+        snap.pointerReleasedThisFrame = this.currentPointerReleased;
+        snap.wheelDeltaThisFrame = this.currentWheelDelta;
+        snap.touchesStartedThisFrame = this.currentTouchesStarted;
+        snap.touchesEndedThisFrame = this.currentTouchesEnded;
+        // Rebuild touches array in place from the active-touches map.
+        const touchesArr = this.cachedTouchesArray;
+        touchesArr.length = 0;
+        for (const tp of this.activeTouches.values()) {
+            touchesArr.push(tp);
+        }
+        return this.cachedSnapshot;
+    }
+    // ---------- Test / synthetic injection helpers ----------
+    // Inject a keydown without a real DOM event (for unit tests).
+    injectKeyDown(code) {
+        if (!this.keysHeld.has(code)) {
+            this.keysPressedAccum.add(code);
+            this.keysHeld.add(code);
+        }
+    }
+    injectKeyUp(code) {
+        if (this.keysHeld.has(code)) {
+            this.keysReleasedAccum.add(code);
+            this.keysHeld.delete(code);
+        }
+    }
+    injectPointerMove(x, y, buttons, inside = true) {
+        this.pointer.x = x;
+        this.pointer.y = y;
+        this.pointer.buttons = buttons;
+        this.pointer.inside = inside;
+    }
+    injectPointerDown(buttonsBit) {
+        this.pointerPressedAccum |= buttonsBit;
+        this.pointer.buttons |= buttonsBit;
+    }
+    injectPointerUp(buttonsBit) {
+        this.pointerReleasedAccum |= buttonsBit;
+        this.pointer.buttons &= ~buttonsBit;
+    }
+    // Inject a synthetic touchstart for tests / virtual-input adapters.
+    // Coordinates are in canvas-internal pixel space (same space as the
+    // real touch listener produces after DPR scaling).
+    injectTouchStart(id, x, y) {
+        const tp = { id, x, y };
+        this.activeTouches.set(id, tp);
+        this.touchesStartedAccum.push(tp);
+    }
+    injectTouchMove(id, x, y) {
+        const tp = { id, x, y };
+        this.activeTouches.set(id, tp);
+    }
+    injectTouchEnd(id, x, y) {
+        const tp = { id, x, y };
+        this.activeTouches.delete(id);
+        this.touchesEndedAccum.push(tp);
+    }
+    // ---------- DOM listener implementations ----------
+    onKeyDown(e) {
+        if (!this.keysHeld.has(e.code)) {
+            this.keysPressedAccum.add(e.code);
+            this.keysHeld.add(e.code);
+        }
+    }
+    onKeyUp(e) {
+        if (this.keysHeld.has(e.code)) {
+            this.keysReleasedAccum.add(e.code);
+            this.keysHeld.delete(e.code);
+        }
+    }
+    updatePointerFromEvent(e) {
+        if (!this.canvas)
+            return;
+        const rect = this.canvas.getBoundingClientRect();
+        // Account for canvas display-size vs internal-resolution: the
+        // canvas may be CSS-scaled. We multiply by the ratio so the
+        // returned coords match the canvas's intrinsic pixel space.
+        const sx = this.canvas.width / Math.max(1, rect.width);
+        const sy = this.canvas.height / Math.max(1, rect.height);
+        this.pointer.x = (e.clientX - rect.left) * sx;
+        this.pointer.y = (e.clientY - rect.top) * sy;
+        this.pointer.buttons = e.buttons;
+        this.pointer.inside = true;
+    }
+    onPointerMove(e) {
+        this.updatePointerFromEvent(e);
+    }
+    onPointerDown(e) {
+        this.updatePointerFromEvent(e);
+        const bit = 1 << e.button;
+        this.pointerPressedAccum |= bit;
+    }
+    onPointerUp(e) {
+        this.updatePointerFromEvent(e);
+        const bit = 1 << e.button;
+        this.pointerReleasedAccum |= bit;
+    }
+    onPointerEnter(e) {
+        this.updatePointerFromEvent(e);
+        this.pointer.inside = true;
+    }
+    onPointerLeave(_e) {
+        this.pointer.inside = false;
+        this.pointer.buttons = 0;
+    }
+    onWheel(e) {
+        this.wheelDeltaAccum += e.deltaY;
+        e.preventDefault();
+    }
+    updateTouchPoint(t) {
+        if (!this.canvas)
+            return { id: t.identifier, x: 0, y: 0 };
+        const rect = this.canvas.getBoundingClientRect();
+        const sx = this.canvas.width / Math.max(1, rect.width);
+        const sy = this.canvas.height / Math.max(1, rect.height);
+        return {
+            id: t.identifier,
+            x: (t.clientX - rect.left) * sx,
+            y: (t.clientY - rect.top) * sy,
+        };
+    }
+    onTouchStart(e) {
+        for (let i = 0; i < e.changedTouches.length; i++) {
+            const t = e.changedTouches[i];
+            if (!t)
+                continue;
+            const tp = this.updateTouchPoint(t);
+            this.activeTouches.set(tp.id, tp);
+            this.touchesStartedAccum.push(tp);
+        }
+        e.preventDefault();
+    }
+    onTouchMove(e) {
+        for (let i = 0; i < e.changedTouches.length; i++) {
+            const t = e.changedTouches[i];
+            if (!t)
+                continue;
+            const tp = this.updateTouchPoint(t);
+            this.activeTouches.set(tp.id, tp);
+        }
+        e.preventDefault();
+    }
+    onTouchEnd(e) {
+        for (let i = 0; i < e.changedTouches.length; i++) {
+            const t = e.changedTouches[i];
+            if (!t)
+                continue;
+            const tp = this.updateTouchPoint(t);
+            this.activeTouches.delete(tp.id);
+            this.touchesEndedAccum.push(tp);
+        }
+    }
+    onTouchCancel(e) {
+        for (let i = 0; i < e.changedTouches.length; i++) {
+            const t = e.changedTouches[i];
+            if (!t)
+                continue;
+            this.activeTouches.delete(t.identifier);
+        }
+    }
+    // Default-prevent the right-click menu so a Phase 6+ ARPG can use
+    // RMB without the OS context menu. Callers that need the menu can
+    // wrap the canvas in a parent and listen there instead.
+    onContextMenu(e) {
+        e.preventDefault();
+    }
+}
+// Resource key. Engine.create registers the InputManager + a current
+// snapshot under these keys.
+export const RESOURCE_INPUT_MANAGER = 'input_manager';
+export const RESOURCE_INPUT = 'input';
+//# sourceMappingURL=input-manager.js.map

package/dist/input/input-manager.js.map

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

package/dist/input/tap-to-walk.d.ts

@@ -0,0 +1,27 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export interface TapWalkTargetResource {
+    x: number;
+    y: number;
+    active: boolean;
+    frameSet: number;
+}
+export declare const RESOURCE_TAP_WALK: 'tap_walk';
+export declare function createTapWalkTarget(): TapWalkTargetResource;
+export interface TapToWalkSystemOptions {
+    moveThresholdPx?: number;
+    maxFrames?: number;
+}
+export declare class TapToWalkSystem implements System {
+    readonly name: string;
+    private inFlight;
+    private moveThresholdSq;
+    private maxFrames;
+    private scratchA;
+    private scratchB;
+    constructor(opts?: TapToWalkSystemOptions);
+    update(world: World, _dt: number): void;
+    private publishTarget;
+    resetInFlight(): void;
+}
+//# sourceMappingURL=tap-to-walk.d.ts.map

package/dist/input/tap-to-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-to-walk.d.ts","sourceRoot":"","sources":["../../src/input/tap-to-walk.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AASzC,MAAM,WAAW,qBAAqB;IAEpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV,MAAM,EAAE,OAAO,CAAC;IAGhB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,iBAAiB,EAAE,UAAuB,CAAC;AAExD,wBAAgB,mBAAmB,IAAI,qBAAqB,CAE3D;AAOD,MAAM,WAAW,sBAAsB;IAIrC,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,qBAAa,eAAgB,YAAW,MAAM;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,SAAS,CAAS;IAG1B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,IAAI,GAAE,sBAA2B;IAM7C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAoDvC,OAAO,CAAC,aAAa;IAqBrB,aAAa,IAAI,IAAI;CAGtB"}

package/dist/input/tap-to-walk.js

@@ -0,0 +1,118 @@
+// TapToWalkSystem - converts a single quick canvas tap into a
+// world-tile target the game can walk to.
+//
+// Touch lifecycle:
+//   - Multi-touch is ignored entirely. A second active touch cancels
+//     the in-flight tap candidate so two-finger gestures (zoom, pan)
+//     don't accidentally drop a walk target.
+//   - A "tap" is a single touch whose start/end happen within
+//     `maxFrames` frames AND whose end position is within
+//     `moveThresholdPx` of its start position.
+//   - On a confirmed tap, the system computes the world-tile target
+//     by inverting the iso projection: canvas pixel -> camera/iso
+//     space via screenToWorld, then iso -> tile via isoToTile.
+//
+// Cancellation:
+//   - Any held WASD or Arrow key clears the target on the same frame
+//     it appears in keysHeld. This is how a manual D-pad press
+//     ("press up to keep walking") cancels an old tap-to-walk goal.
+//
+// The target is published to RESOURCE_TAP_WALK as a small mutable
+// resource: { x, y, active, frameSet }. Consumers (the player-move
+// system) read it each tick. The system never owns the player entity
+// or the movement logic - it just publishes the target.
+import { RESOURCE_INPUT } from './input-manager.js';
+import { RESOURCE_TIME, RESOURCE_CAMERA } from '../resources.js';
+import { screenToWorld } from '../renderer/camera.js';
+import { isoToTile } from '../renderer/iso-projection.js';
+export const RESOURCE_TAP_WALK = 'tap_walk';
+export function createTapWalkTarget() {
+    return { x: 0, y: 0, active: false, frameSet: -1 };
+}
+const CANCEL_KEYS = [
+    'KeyW', 'KeyA', 'KeyS', 'KeyD',
+    'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight',
+];
+export class TapToWalkSystem {
+    name = 'tap-to-walk';
+    inFlight = null;
+    moveThresholdSq;
+    maxFrames;
+    // Scratch vectors so per-frame iso math doesn't allocate.
+    scratchA = { x: 0, y: 0 };
+    scratchB = { x: 0, y: 0 };
+    constructor(opts = {}) {
+        const px = opts.moveThresholdPx ?? 12;
+        this.moveThresholdSq = px * px;
+        this.maxFrames = opts.maxFrames ?? 30;
+    }
+    update(world, _dt) {
+        const input = world.resources.get(RESOURCE_INPUT);
+        if (!input)
+            return;
+        const time = world.resources.require(RESOURCE_TIME);
+        const target = world.resources.get(RESOURCE_TAP_WALK);
+        if (!target)
+            return;
+        // Manual movement (keyboard or D-pad-injected WASD) cancels any
+        // pending walk target.
+        for (const code of CANCEL_KEYS) {
+            if (input.keysHeld.has(code)) {
+                target.active = false;
+                this.inFlight = null;
+                return;
+            }
+        }
+        // Multi-touch -> abort tap candidacy. Two-finger gestures should
+        // never resolve to a walk command.
+        if (input.touches.length > 1) {
+            this.inFlight = null;
+            return;
+        }
+        // Track the first touchstart of an idle frame.
+        if (this.inFlight === null && input.touchesStartedThisFrame.length > 0) {
+            const t = input.touchesStartedThisFrame[0];
+            this.inFlight = {
+                id: t.id,
+                startX: t.x,
+                startY: t.y,
+                startFrame: time.frame,
+            };
+        }
+        // Resolve on touchend matching the in-flight id.
+        if (this.inFlight !== null) {
+            for (const ended of input.touchesEndedThisFrame) {
+                if (ended.id !== this.inFlight.id)
+                    continue;
+                const dx = ended.x - this.inFlight.startX;
+                const dy = ended.y - this.inFlight.startY;
+                const distSq = dx * dx + dy * dy;
+                const frames = time.frame - this.inFlight.startFrame;
+                if (distSq <= this.moveThresholdSq && frames <= this.maxFrames) {
+                    this.publishTarget(world, target, ended.x, ended.y, time.frame);
+                }
+                this.inFlight = null;
+                break;
+            }
+        }
+    }
+    publishTarget(world, target, canvasPxX, canvasPxY, frame) {
+        const camera = world.resources.get(RESOURCE_CAMERA);
+        if (!camera)
+            return;
+        // Canvas pixel -> iso (camera) space.
+        screenToWorld(camera, canvasPxX, canvasPxY, this.scratchA);
+        // Iso -> world tile.
+        isoToTile(this.scratchA.x, this.scratchA.y, this.scratchB);
+        target.x = this.scratchB.x;
+        target.y = this.scratchB.y;
+        target.active = true;
+        target.frameSet = frame;
+    }
+    // Test helper: clear any in-flight tap candidate. Mostly used by
+    // tests that want to drive the system through state transitions.
+    resetInFlight() {
+        this.inFlight = null;
+    }
+}
+//# sourceMappingURL=tap-to-walk.js.map

package/dist/input/tap-to-walk.js.map

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

package/dist/input/virtual-dpad.d.ts

@@ -0,0 +1,34 @@
+import { InputManager } from './input-manager.js';
+export type DpadDirection = 'up' | 'down' | 'left' | 'right';
+export interface VirtualDpadOptions {
+    inputManager: InputManager;
+    parent?: HTMLElement;
+    document?: Document;
+    visible?: boolean;
+    onPress?: (dir: DpadDirection) => void;
+}
+export declare class VirtualDpad {
+    private opts;
+    private root;
+    private buttons;
+    private mounted;
+    private visible;
+    constructor(opts: VirtualDpadOptions);
+    static detectTouchSupport(win?: Window): boolean;
+    isMounted(): boolean;
+    isVisible(): boolean;
+    mount(): void;
+    unmount(): void;
+    pressDirection(dir: DpadDirection, touchId?: number): void;
+    releaseDirection(dir: DpadDirection, touchId?: number): void;
+    pressedTouchCount(dir: DpadDirection): number;
+    private requireButton;
+    private buildButton;
+    private spacer;
+    private deadzone;
+    private styleRoot;
+    private styleGrid;
+    private styleButton;
+    private attachListeners;
+}
+//# sourceMappingURL=virtual-dpad.d.ts.map

package/dist/input/virtual-dpad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-dpad.d.ts","sourceRoot":"","sources":["../../src/input/virtual-dpad.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS7D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,YAAY,CAAC;IAE3B,MAAM,CAAC,EAAE,WAAW,CAAC;IAGrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAIpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;CACxC;AAOD,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,OAAO,CAAuD;IACtE,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAU;gBAEb,IAAI,EAAE,kBAAkB;IASpC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAShD,SAAS,IAAI,OAAO;IAIpB,SAAS,IAAI,OAAO;IAMpB,KAAK,IAAI,IAAI;IA2Cb,OAAO,IAAI,IAAI;IAqBf,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,MAAW,GAAG,IAAI;IAU9D,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,MAAW,GAAG,IAAI;IAUhE,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM;IAK7C,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,eAAe;CAqCxB"}