@joknoll/svelte-attach-gamepad 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# @joknoll/svelte-attach-gamepad
+
+A small Svelte 5 helper for reading [Gamepad API](https://developer.mozilla.org/en-US/docs/Web/API/Gamepad_API) button state.
+
+## Installation
+
+```
+npm install @joknoll/svelte-attach-gamepad
+```
+
+## Usage
+
+```ts
+import { isSupported, isButtonPressed, GamepadButtonMap } from "@joknoll/svelte-attach-gamepad";
+
+if (isButtonPressed("A")) {
+  // first connected gamepad, "A" button held
+}
+```
+
+## API
+
+### `isSupported`
+
+Boolean indicating whether `navigator.getGamepads` is available.
+
+### `isButtonPressed(button, padIndex = 0)`
+
+Returns whether the named button is currently pressed on the gamepad at `padIndex`.
+No-ops to `false` when the Gamepad API is unavailable (e.g. SSR) or no pad is
+connected at that index.
+
+### `GamepadButtonMap` / `ButtonName`
+
+The standard gamepad button name → index map, and the union of valid button names
+(`"A"`, `"B"`, `"X"`, `"Y"`, `"LB"`, `"RB"`, `"LT"`, `"RT"`, `"SELECT"`, `"START"`,
+`"UP"`, `"DOWN"`, `"LEFT"`, `"RIGHT"`).

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+//#region src/buttons.d.ts
+declare const GamepadButtonMap: {
+  readonly A: 0;
+  readonly B: 1;
+  readonly X: 2;
+  readonly Y: 3;
+  readonly LB: 4;
+  readonly RB: 5;
+  readonly LT: 6;
+  readonly RT: 7;
+  readonly SELECT: 8;
+  readonly START: 9;
+  readonly UP: 12;
+  readonly DOWN: 13;
+  readonly LEFT: 14;
+  readonly RIGHT: 15;
+};
+type ButtonName = keyof typeof GamepadButtonMap;
+//#endregion
+//#region src/index.d.ts
+/** Whether the Gamepad API is available in the current environment. */
+declare const isSupported: boolean;
+/**
+ * Returns whether the named button is currently pressed on the gamepad at
+ * `padIndex`. No-ops to `false` when the Gamepad API is unavailable (e.g. SSR)
+ * or no pad is connected at that index.
+ */
+declare function isButtonPressed(buttonName: ButtonName, padIndex?: number): boolean;
+//#endregion
+export { type ButtonName, GamepadButtonMap, isButtonPressed, isSupported };

package/dist/index.js

@@ -0,0 +1 @@
+const e={A:0,B:1,X:2,Y:3,LB:4,RB:5,LT:6,RT:7,SELECT:8,START:9,UP:12,DOWN:13,LEFT:14,RIGHT:15},t=typeof navigator<`u`&&typeof navigator.getGamepads==`function`;function n(n,r=0){if(!t)return!1;let i=navigator.getGamepads()[r];return i?i.buttons[e[n]]?.pressed??!1:!1}export{e as GamepadButtonMap,n as isButtonPressed,t as isSupported};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@joknoll/svelte-attach-gamepad",
+  "version": "0.1.0",
+  "description": "A Svelte helper for reading gamepad button state.",
+  "keywords": [
+    "attachment",
+    "gamepad",
+    "svelte",
+    "svelte5"
+  ],
+  "homepage": "https://github.com/joknoll/svelte-attach/tree/main/packages/gamepad#readme",
+  "bugs": {
+    "url": "https://github.com/joknoll/svelte-attach/issues"
+  },
+  "license": "MIT",
+  "author": "joknoll",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joknoll/svelte-attach.git",
+    "directory": "packages/gamepad"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "@typescript/native-preview": "7.0.0-dev.20260509.2",
+    "bumpp": "^11.1.0",
+    "svelte": "^5.55.0",
+    "typescript": "^6.0.3",
+    "vite-plus": "latest"
+  },
+  "peerDependencies": {
+    "svelte": ">=5.55.0"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test --passWithNoTests",
+    "check": "vp check"
+  }
+}