@vibedgames/gamepad 0.1.0

package/dist/physical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physical.d.ts","sourceRoot":"","sources":["../src/physical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;sEACsE;AACtE,MAAM,MAAM,SAAS,GACjB,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,QAAQ,GACR,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AA8CZ,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC,CAAC;IAC1D,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC5C,CAAC;AAyBF;wDACwD;AACxD,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;IAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAE3D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,QAAQ,CAAwB;IACxC,oDAAoD;IACpD,OAAO,CAAC,MAAM,CAAgC;IAE9C,YAAY,OAAO,GAAE,sBAA2B,EAO/C;IAED,2EAA2E;IAC3E,MAAM,IAAI,IAAI,CA+Bb;IAED,qDAAqD;IACrD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,mEAAmE;IACnE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEhC;IAED,4EAA4E;IAC5E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG/B;IAED,gFAAgF;IAChF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAGhC;IAED,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAErC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAI,GAAE,MAAM,GAAG,OAAgB,GAAG,UAAU,CAoBpD;IAED,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAMd;IAED,OAAO,CAAC,OAAO;CAKhB"}

package/dist/physical.js

@@ -0,0 +1,201 @@
+const BUTTON_INDEX = {
+    a: 0,
+    b: 1,
+    x: 2,
+    y: 3,
+    lb: 4,
+    rb: 5,
+    lt: 6,
+    rt: 7,
+    select: 8,
+    start: 9,
+    ls: 10,
+    rs: 11,
+    up: 12,
+    down: 13,
+    left: 14,
+    right: 15,
+};
+const PAD_BUTTONS = [
+    "a",
+    "b",
+    "x",
+    "y",
+    "lb",
+    "rb",
+    "lt",
+    "rt",
+    "select",
+    "start",
+    "ls",
+    "rs",
+    "up",
+    "down",
+    "left",
+    "right",
+];
+const PAD_BUTTON_NAMES = new Set(PAD_BUTTONS);
+function isPadButton(id) {
+    return PAD_BUTTON_NAMES.has(id);
+}
+const DEFAULT_STICK_DEAD_ZONE = 0.15;
+const DEFAULT_TRIGGER_THRESHOLD = 0.05;
+const IDLE_STICK = {
+    active: false,
+    anchorX: 0,
+    anchorY: 0,
+    curX: 0,
+    curY: 0,
+    dx: 0,
+    dy: 0,
+    distance: 0,
+    angle: 0,
+    magnitude: 0,
+    inDeadZone: true,
+};
+function defaultPoll() {
+    return typeof navigator !== "undefined" && typeof navigator.getGamepads === "function"
+        ? navigator.getGamepads()
+        : [];
+}
+/** True if any physical pad is currently connected — e.g. to decide whether
+ *  controller rows belong on an instructions screen. */
+export function isPadConnected() {
+    return defaultPoll().some((pad) => pad?.connected ?? false);
+}
+/**
+ * Physical controller input, API-mirroring {@link VirtualGamepad} so a game's
+ * read path works for both: `isButtonDown(id)` / `justPressed(id)` /
+ * `getStick()`. Poll-based — call `update()` once per frame; edges are
+ * published per update, matching the virtual pad's `nextFrame()` semantics.
+ * The first connected pad wins. No DOM, no engine, no listeners.
+ *
+ * ```ts
+ * const pad = new PhysicalGamepad({ bindings: { jump: ["a"], dash: ["b", "rb"] } });
+ * // in your game loop:
+ * pad.update();
+ * const dir = stickDirection4(pad.getStick());
+ * if (pad.justPressed("jump")) jump();
+ * ```
+ */
+export class PhysicalGamepad {
+    bindings;
+    stickDeadZone;
+    triggerThreshold;
+    onConnect;
+    onDisconnect;
+    poll;
+    wasConnected = false;
+    axes = [];
+    down = new Set();
+    prevDown = new Set();
+    /** Raw analog values (triggers), by button name. */
+    values = new Map();
+    constructor(options = {}) {
+        this.bindings = options.bindings ?? {};
+        this.stickDeadZone = options.stickDeadZone ?? DEFAULT_STICK_DEAD_ZONE;
+        this.triggerThreshold = options.triggerThreshold ?? DEFAULT_TRIGGER_THRESHOLD;
+        this.onConnect = options.onConnect;
+        this.onDisconnect = options.onDisconnect;
+        this.poll = options.poll ?? defaultPoll;
+    }
+    /** Poll the first connected pad and publish press edges for this frame. */
+    update() {
+        let pad = null;
+        for (const candidate of this.poll()) {
+            if (candidate?.connected) {
+                pad = candidate;
+                break;
+            }
+        }
+        const connected = pad !== null;
+        if (connected !== this.wasConnected) {
+            this.wasConnected = connected;
+            if (connected)
+                this.onConnect?.();
+            else
+                this.onDisconnect?.();
+        }
+        // Swap, then rebuild — prevDown keeps last frame's state for edge reads.
+        [this.prevDown, this.down] = [this.down, this.prevDown];
+        this.down.clear();
+        this.values.clear();
+        this.axes = pad ? [...pad.axes] : [];
+        if (!pad)
+            return;
+        for (const name of PAD_BUTTONS) {
+            const button = pad.buttons[BUTTON_INDEX[name]];
+            if (!button)
+                continue;
+            this.values.set(name, button.value);
+            // Triggers report analog values; some pads never set `pressed` for a
+            // light pull, so a value past the threshold also counts as down.
+            if (button.pressed || button.value > this.triggerThreshold)
+                this.down.add(name);
+        }
+    }
+    /** A pad was connected as of the last `update()`. */
+    get connected() {
+        return this.wasConnected;
+    }
+    /** `id` is a binding action id or a raw {@link PadButton} name. */
+    isButtonDown(id) {
+        return this.resolve(id).some((b) => this.down.has(b));
+    }
+    /** Action went up→down since the previous `update()` (any bound button). */
+    justPressed(id) {
+        const buttons = this.resolve(id);
+        return buttons.some((b) => this.down.has(b)) && !buttons.some((b) => this.prevDown.has(b));
+    }
+    /** Action went down→up since the previous `update()` (all bound buttons up). */
+    justReleased(id) {
+        const buttons = this.resolve(id);
+        return buttons.some((b) => this.prevDown.has(b)) && !buttons.some((b) => this.down.has(b));
+    }
+    /** Raw analog value 0–1 (triggers are the interesting case). 0 when absent. */
+    buttonValue(button) {
+        return this.values.get(button) ?? 0;
+    }
+    /**
+     * A stick reading in {@link StickState} form (axes 0/1 left, 2/3 right;
+     * y-down matches screen space), so `stickDirection4/8` work unchanged.
+     * `active` while a pad is connected; dead-zoned like the virtual stick.
+     */
+    getStick(side = "left") {
+        if (!this.wasConnected)
+            return { ...IDLE_STICK };
+        const base = side === "left" ? 0 : 2;
+        const dx = this.axes[base] ?? 0;
+        const dy = this.axes[base + 1] ?? 0;
+        const distance = Math.hypot(dx, dy);
+        const span = Math.max(1e-6, 1 - this.stickDeadZone);
+        return {
+            active: true,
+            anchorX: 0,
+            anchorY: 0,
+            curX: dx,
+            curY: dy,
+            dx,
+            dy,
+            distance,
+            angle: Math.atan2(dy, dx),
+            magnitude: Math.min(1, Math.max(0, (distance - this.stickDeadZone) / span)),
+            inDeadZone: distance <= this.stickDeadZone,
+        };
+    }
+    /** Release all state (the class holds no listeners — this just clears). */
+    destroy() {
+        this.down.clear();
+        this.prevDown.clear();
+        this.values.clear();
+        this.axes = [];
+        this.wasConnected = false;
+    }
+    resolve(id) {
+        const bound = this.bindings[id];
+        if (bound)
+            return bound;
+        return isPadButton(id) ? [id] : [];
+    }
+}
+//# sourceMappingURL=physical.js.map

package/dist/physical.js.map

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

package/dist/safe-area.d.ts

@@ -0,0 +1,11 @@
+import type { Inset, VisibilityPolicy } from "./types";
+/**
+ * Read the device safe-area insets (`env(safe-area-inset-*)`) via a hidden
+ * probe element, for feeding `VirtualGamepad.setViewport`. Returns zeros when
+ * there is no DOM or no notch. Requires `viewport-fit=cover` in the page's
+ * viewport meta tag to report non-zero values on iOS.
+ */
+export declare function safeAreaInset(): Inset;
+/** Whether the overlay should render before any touch has been seen. */
+export declare function preShow(policy: VisibilityPolicy): boolean;
+//# sourceMappingURL=safe-area.d.ts.map

package/dist/safe-area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-area.d.ts","sourceRoot":"","sources":["../src/safe-area.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMvD;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAiBrC;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAOzD"}

package/dist/safe-area.js

@@ -0,0 +1,37 @@
+const ZERO = { top: 0, right: 0, bottom: 0, left: 0 };
+let probe = null;
+/**
+ * Read the device safe-area insets (`env(safe-area-inset-*)`) via a hidden
+ * probe element, for feeding `VirtualGamepad.setViewport`. Returns zeros when
+ * there is no DOM or no notch. Requires `viewport-fit=cover` in the page's
+ * viewport meta tag to report non-zero values on iOS.
+ */
+export function safeAreaInset() {
+    if (typeof document === "undefined" || !document.body)
+        return ZERO;
+    if (!probe || !probe.isConnected) {
+        probe = document.createElement("div");
+        probe.style.cssText =
+            "position:fixed;top:0;left:0;visibility:hidden;pointer-events:none;" +
+                "padding:env(safe-area-inset-top) env(safe-area-inset-right) " +
+                "env(safe-area-inset-bottom) env(safe-area-inset-left);";
+        document.body.appendChild(probe);
+    }
+    const s = getComputedStyle(probe);
+    return {
+        top: Number.parseFloat(s.paddingTop) || 0,
+        right: Number.parseFloat(s.paddingRight) || 0,
+        bottom: Number.parseFloat(s.paddingBottom) || 0,
+        left: Number.parseFloat(s.paddingLeft) || 0,
+    };
+}
+/** Whether the overlay should render before any touch has been seen. */
+export function preShow(policy) {
+    if (policy === "always")
+        return true;
+    if (policy !== "coarse")
+        return false;
+    return (typeof window !== "undefined" &&
+        (window.matchMedia("(pointer: coarse)").matches || "ontouchstart" in window));
+}
+//# sourceMappingURL=safe-area.js.map

package/dist/safe-area.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-area.js","sourceRoot":"","sources":["../src/safe-area.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAU,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAE7D,IAAI,KAAK,GAAuB,IAAI,CAAC;AAErC;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACnE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACjC,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,CAAC,KAAK,CAAC,OAAO;YACjB,oEAAoE;gBACpE,8DAA8D;gBAC9D,wDAAwD,CAAC;QAC3D,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QACzC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;QAC7C,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;QAC/C,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,OAAO,CAAC,MAAwB;IAC9C,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,CACL,OAAO,MAAM,KAAK,WAAW;QAC7B,CAAC,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,OAAO,IAAI,cAAc,IAAI,MAAM,CAAC,CAC7E,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+/** A 2D point / vector in screen-space pixels. */
+export type Vec2 = {
+    x: number;
+    y: number;
+};
+/** Device safe-area insets (notch / home indicator), screen-space px. */
+export type Inset = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+/** Current canvas size + safe-area insets, used to re-anchor fixed buttons on
+ *  resize. Position resolvers should keep bottom/side-anchored buttons clear
+ *  of `inset` (zeros on devices without notches). */
+export type Viewport = {
+    width: number;
+    height: number;
+    inset: Inset;
+};
+/** When the overlay is shown: after the first touch (default), pre-shown on
+ *  coarse-pointer devices so buttons are discoverable, or always. */
+export type VisibilityPolicy = "touch" | "coarse" | "always";
+/** Tuning for the floating analog stick. All distances are screen-space px. */
+export type StickOptions = {
+    /** Drag distance from the anchor that maps to full magnitude (1.0). */
+    radius?: number;
+    /** No magnitude / no aim within this drag of the anchor — a parked thumb
+     *  doesn't jitter the heading. */
+    deadZone?: number;
+    /** Visual knob (inner puck) radius, used by renderers. */
+    knobRadius?: number;
+};
+/** A button on the virtual gamepad. */
+export type ButtonOptions = {
+    /** Stable id you read back with `isButtonDown(id)`. */
+    id: string;
+    /** Fixed on-screen button: resolves a center given the current viewport, so
+     *  the button re-anchors on resize. Omit `position` to make this a "rest"
+     *  button that captures ANY touch not on the stick or another fixed button
+     *  (the "any other finger fires" model). */
+    position?: (viewport: Viewport) => Vec2;
+    /** Hit-test + render radius for a fixed button. Ignored by rest buttons. */
+    radius?: number;
+    /** Optional glyph/label a custom renderer may draw. */
+    label?: string;
+};
+export type VirtualGamepadOptions = {
+    /** Floating analog stick config, or `false` to disable the stick entirely. */
+    stick?: StickOptions | false;
+    /** Action buttons (fixed or "rest"). Evaluated in order on each touch — put
+     *  the most specific fixed buttons first; a "rest" button (if any) is the
+     *  fallback for touches that hit nothing else. */
+    buttons?: ButtonOptions[];
+    /** Edge callback the first frame a button goes from up→down (e.g. place a
+     *  bomb on tap). For held input, read `isButtonDown` each frame instead. */
+    onButtonDown?: (id: string) => void;
+    /** Edge callback when the last finger leaves a button (down→up). */
+    onButtonUp?: (id: string) => void;
+};
+/** A read-only snapshot of the stick. Fields collapse to 0 when idle. */
+export type StickState = {
+    /** A finger is on the stick. */
+    active: boolean;
+    /** Where the finger first landed. */
+    anchorX: number;
+    anchorY: number;
+    /** Current finger position. */
+    curX: number;
+    curY: number;
+    /** Current minus anchor. */
+    dx: number;
+    dy: number;
+    /** Raw drag distance from the anchor (un-clamped). */
+    distance: number;
+    /** Drag heading in radians (`atan2(dy, dx)`, screen-space y-down); 0 idle. */
+    angle: number;
+    /** 0–1 thrust after the dead zone, clamped at `radius`. */
+    magnitude: number;
+    /** Drag is within the dead zone — don't re-aim or thrust this frame. */
+    inDeadZone: boolean;
+};
+/** Resolved stick tuning (defaults applied), for renderers. */
+export type StickGeometry = {
+    radius: number;
+    deadZone: number;
+    knobRadius: number;
+};
+/** Resolved button geometry + state, for renderers. */
+export type ButtonLayout = {
+    id: string;
+    /** Center (0,0 for rest buttons, which have no fixed position). */
+    x: number;
+    y: number;
+    radius: number;
+    label?: string;
+    pressed: boolean;
+    /** Rest buttons have no fixed position — renderers skip them. */
+    rest: boolean;
+};
+/** Four-way snapped direction (screen-space: +y is down). */
+export type Dir4 = "up" | "down" | "left" | "right";
+/** Eight-way snapped direction. */
+export type Dir8 = Dir4 | "up-left" | "up-right" | "down-left" | "down-right";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@vibedgames/gamepad",
+  "version": "0.1.0",
+  "private": false,
+  "description": "On-screen touch controls for browser games — framework-agnostic core + DOM and Phaser adapters",
+  "keywords": [
+    "gamedev",
+    "gamepad",
+    "joystick",
+    "mobile",
+    "phaser",
+    "touch",
+    "virtual-controller"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kyh/vibedgames",
+    "directory": "packages/gamepad"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./dom": {
+      "types": "./dist/dom.d.ts",
+      "default": "./dist/dom.js"
+    },
+    "./phaser": {
+      "types": "./dist/phaser.d.ts",
+      "default": "./dist/phaser.js"
+    }
+  },
+  "devDependencies": {
+    "@kyh/tsconfig": "^1.1.14",
+    "phaser": "^4.2.1",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "phaser": ">=3"
+  },
+  "peerDependenciesMeta": {
+    "phaser": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf .cache .turbo dist node_modules",
+    "typecheck": "tsc --noEmit"
+  }
+}