ps5-controller-webhid 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ps5-controller-webhid contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,240 @@
+# ps5-controller-webhid
+
+**Unofficial, typed WebHID implementation for PS5 DualSense controllers.**
+
+Use named buttons, sticks, triggers, motion sensors, touch contacts, battery
+state, adaptive triggers, and haptic feedback without implementing Sony HID
+reports or guessing browser gamepad indexes.
+
+The repository also includes **PS5 Controller Tester**, a live utility that
+consumes the exact same public client exported by the package.
+
+## Install
+
+```bash
+npm install ps5-controller-webhid
+```
+
+The package is browser-only and requires WebHID in a secure context
+(`localhost` or HTTPS).
+
+## Minimal usage
+
+```ts
+import { PS5Controller } from 'ps5-controller-webhid'
+
+const controller = new PS5Controller({ pollRateHz: 60 })
+
+controller.onError(console.error)
+
+// WebHID permission requests must run inside a user gesture.
+connectButton.addEventListener('click', () => controller.connect())
+
+controller.subscribe((input) => {
+  if (!input.connected) return
+
+  console.log(input.transport)
+  console.log(input.sticks.left)
+  console.log(input.triggers.right)
+  console.log(input.buttons.cross)
+  console.log(input.motion.orientation)
+})
+```
+
+For a game loop, call `controller.read()` synchronously instead of subscribing.
+
+## React
+
+React is an optional peer dependency and is isolated in a subpath export:
+
+```tsx
+import {
+  PS5Controller,
+  usePS5Controller,
+} from 'ps5-controller-webhid/react'
+
+const controller = new PS5Controller()
+
+export function ControllerStatus() {
+  const input = usePS5Controller(controller)
+
+  return (
+    <>
+      <button onClick={() => controller.connect()}>Connect controller</button>
+      <span>{input.connected ? input.transport : 'Disconnected'}</span>
+    </>
+  )
+}
+```
+
+Create one client outside the component render path and call `dispose()` when
+the owning application shuts down.
+
+## Outputs
+
+```ts
+import {
+  PS5Controller,
+  TriggerEffect,
+} from 'ps5-controller-webhid'
+
+const controller = new PS5Controller()
+
+controller.setRumble(0.8, 0.4)
+await controller.pulseRumble(0.8, 0.4, 250)
+
+controller.setTriggerFeedback('right', {
+  effect: TriggerEffect.Feedback,
+  position: 0.2,
+  strength: 0.85,
+})
+
+controller.resetOutputs()
+```
+
+`dispose()` also stops haptics and resets both adaptive triggers.
+
+## Normalized state
+
+`PS5ControllerState` includes:
+
+- `connected`, `transport`, and report capability status
+- `sticks.left/right.x/y` from `-1` to `1`
+- `triggers.left/right` from `0` to `1`
+- named digital inputs in `buttons`
+- calibrated gyroscope and accelerometer axes
+- fused Euler orientation and quaternion
+- two touchpad contacts
+- battery and charging state
+- product, board revision, firmware, and serial identity
+
+The full runtime button list is exported as `DUALSENSE_BUTTONS`. Types are
+available as `PS5ControllerButton`, `PS5ControllerOptions`, and
+`PS5ControllerState`.
+
+## Detailed integration
+
+See [`docs/INTEGRATION.md`](docs/INTEGRATION.md) for:
+
+- plain TypeScript integration
+- React subscription patterns
+- React Three Fiber and Rapier flight input
+- complete state units and ranges
+- haptic and adaptive-trigger examples
+- lifecycle and cleanup requirements
+
+## Run the tester
+
+```bash
+npm install
+npm run dev
+```
+
+Open the localhost URL in desktop Chrome or Edge, connect the controller, and
+complete the required tests. The tester generates a local JSON report with the
+browser, transport, firmware, board revision, observed inputs, motion check,
+and physical output confirmations.
+
+## Bluetooth pairing on macOS
+
+1. Disconnect the USB cable.
+2. Hold **Create** and the **PS logo button** until the blue lights flash.
+3. Connect **DualSense Wireless Controller** in macOS Bluetooth settings.
+4. Select **Find PS5 controller**, then choose the controller in Chrome's
+   secure WebHID picker.
+
+Bluetooth supports the package inputs, motion sensors, adaptive triggers, and
+haptic output.
+
+## Build the npm package
+
+```bash
+npm run build:package
+```
+
+Generated package files are written to `lib/`:
+
+- ESM: `index.js` and `react.js`
+- CommonJS: `index.cjs` and `react.cjs`
+- TypeScript declarations and source maps
+
+Inspect exactly what npm would publish:
+
+```bash
+npm run pack:check
+```
+
+The tester production build is separate:
+
+```bash
+npm run build:tester
+```
+
+Run every repository check with:
+
+```bash
+npm run check
+```
+
+## Deploy the tester to Vercel
+
+Import the GitHub repository into Vercel and use:
+
+- Framework preset: **Vite**
+- Build command: `npm run build:tester`
+- Output directory: `dist`
+
+No environment variables are required. Vercel provides HTTPS, which satisfies
+WebHID's secure-context requirement. Device permission must still be requested
+from a user click.
+
+## Source layout
+
+```text
+src/
+  dualsense/       Published framework-independent client and React entry
+  diagnostics/     Tester-only pass/fail workflow
+  components/      Tester interface
+docs/
+  INTEGRATION.md   Copy-ready application examples
+public/
+  ps5-controller-hero.jpg
+  ps5-controller-gyro-clean.png
+```
+
+## Support
+
+The current release targets a standard DualSense controller in desktop
+Chromium browsers. DualSense Edge, DualSense Access, DualShock 4, Safari, and
+Firefox are not currently supported.
+
+The Bluetooth path has been physically verified on a BDM-050 controller with
+firmware 1.15.10 using Chrome 150 on macOS. Hardware and browser combinations
+still need their own testing.
+
+## Privacy and safety
+
+Controller data stays in the browser. The package and tester contain no
+backend, analytics, telemetry, advertising, or AI integration.
+
+WebHID access requires an explicit user action. Avoid opening multiple WebHID
+controller tools simultaneously, and always call `resetOutputs()` or
+`dispose()` when leaving an experience.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Changes to the public client should be
+validated through the tester because it consumes the same hardware path.
+
+This package builds on
+[`dualsense-ts`](https://github.com/nsfm/dualsense-ts), distributed under
+LGPL-3.0.
+
+## License and trademark notice
+
+The wrapper code is released under the [MIT License](LICENSE).
+
+DualSense, PlayStation, and PS5 are trademarks of Sony Interactive
+Entertainment. `ps5-controller-webhid` and PS5 Controller Tester are
+independent community projects and are not affiliated with or endorsed by Sony
+Interactive Entertainment.

package/lib/index.cjs

@@ -0,0 +1,337 @@
+'use strict';
+
+var dualsenseTs = require('dualsense-ts');
+
+// src/dualsense/index.ts
+var DUALSENSE_BUTTONS = [
+  { key: "cross", label: "Cross" },
+  { key: "circle", label: "Circle" },
+  { key: "square", label: "Square" },
+  { key: "triangle", label: "Triangle" },
+  { key: "dpadUp", label: "D-pad up" },
+  { key: "dpadRight", label: "D-pad right" },
+  { key: "dpadDown", label: "D-pad down" },
+  { key: "dpadLeft", label: "D-pad left" },
+  { key: "l1", label: "L1" },
+  { key: "r1", label: "R1" },
+  { key: "l2Digital", label: "L2 digital" },
+  { key: "r2Digital", label: "R2 digital" },
+  { key: "l3", label: "L3 / left stick press" },
+  { key: "r3", label: "R3 / right stick press" },
+  { key: "create", label: "Create" },
+  { key: "options", label: "Options" },
+  { key: "touchpad", label: "Touchpad press" },
+  { key: "mute", label: "Mute" },
+  { key: "ps", label: "PS" }
+];
+function createNeutralButtonState() {
+  return Object.fromEntries(
+    DUALSENSE_BUTTONS.map(({ key }) => [key, false])
+  );
+}
+function createNeutralSnapshot() {
+  return {
+    connected: false,
+    transport: "Disconnected",
+    limited: false,
+    identityReady: false,
+    productName: "DualSense",
+    serialNumber: "",
+    boardRevision: "",
+    firmware: "",
+    sticks: {
+      left: { x: 0, y: 0 },
+      right: { x: 0, y: 0 }
+    },
+    triggers: {
+      left: 0,
+      right: 0
+    },
+    buttons: createNeutralButtonState(),
+    motion: {
+      gyro: { x: 0, y: 0, z: 0 },
+      accelerometer: { x: 0, y: 0, z: 0 },
+      orientation: { x: 0, y: 0, z: 0 },
+      quaternion: [1, 0, 0, 0],
+      sensorTimestamp: 0
+    },
+    touchpad: {
+      primary: { active: false, id: 0, x: 0, y: 0 },
+      secondary: { active: false, id: 0, x: 0, y: 0 }
+    },
+    battery: {
+      level: 0,
+      status: dualsenseTs.ChargeStatus.Discharging
+    }
+  };
+}
+
+// src/dualsense/DualSenseClient.ts
+var degrees = (radians) => radians * 180 / Math.PI;
+var clamp = (value) => Math.min(1, Math.max(0, value));
+var wait = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+function getDualSenseSupport() {
+  const webHID = typeof navigator !== "undefined" && "hid" in navigator;
+  const secureContext = typeof window !== "undefined" && window.isSecureContext;
+  return {
+    webHID,
+    secureContext,
+    supported: webHID && secureContext
+  };
+}
+function readController(controller) {
+  const connected = controller.connection.active;
+  const firmware = controller.firmwareInfo.mainFirmwareVersion;
+  const providerDevice = controller.hid.provider.device;
+  const productName = providerDevice && "productName" in providerDevice ? providerDevice.productName : "DualSense";
+  const quaternion = controller.orientation.quaternion;
+  return {
+    connected,
+    transport: connected ? controller.wireless ? "Bluetooth" : "USB" : "Disconnected",
+    limited: controller.hid.provider.limited ?? false,
+    identityReady: controller.hid.ready,
+    productName,
+    serialNumber: controller.factoryInfo.serialNumber,
+    boardRevision: controller.factoryInfo.boardRevision,
+    firmware: firmware.major || firmware.minor || firmware.patch ? `${firmware.major}.${firmware.minor}.${firmware.patch}` : "",
+    sticks: {
+      left: {
+        x: controller.left.analog.x.state,
+        y: controller.left.analog.y.state
+      },
+      right: {
+        x: controller.right.analog.x.state,
+        y: controller.right.analog.y.state
+      }
+    },
+    triggers: {
+      left: controller.left.trigger.pressure,
+      right: controller.right.trigger.pressure
+    },
+    buttons: {
+      cross: controller.cross.state,
+      circle: controller.circle.state,
+      square: controller.square.state,
+      triangle: controller.triangle.state,
+      dpadUp: controller.dpad.up.state,
+      dpadRight: controller.dpad.right.state,
+      dpadDown: controller.dpad.down.state,
+      dpadLeft: controller.dpad.left.state,
+      l1: controller.left.bumper.state,
+      r1: controller.right.bumper.state,
+      l2Digital: controller.left.trigger.button.state,
+      r2Digital: controller.right.trigger.button.state,
+      l3: controller.left.analog.button.state,
+      r3: controller.right.analog.button.state,
+      create: controller.create.state,
+      options: controller.options.state,
+      touchpad: controller.touchpad.button.state,
+      mute: controller.mute.state,
+      ps: controller.ps.state
+    },
+    motion: {
+      gyro: {
+        x: controller.gyroscope.x.state,
+        y: controller.gyroscope.y.state,
+        z: controller.gyroscope.z.state
+      },
+      accelerometer: {
+        x: controller.accelerometer.x.state,
+        y: controller.accelerometer.y.state,
+        z: controller.accelerometer.z.state
+      },
+      orientation: {
+        x: degrees(controller.orientation.pitch),
+        y: degrees(controller.orientation.yaw),
+        z: degrees(controller.orientation.roll)
+      },
+      quaternion: [
+        quaternion[0],
+        quaternion[1],
+        quaternion[2],
+        quaternion[3]
+      ],
+      sensorTimestamp: controller.sensorTimestamp
+    },
+    touchpad: {
+      primary: {
+        active: controller.touchpad.left.contact.state,
+        id: controller.touchpad.left.tracker.state,
+        x: controller.touchpad.left.x.state,
+        y: controller.touchpad.left.y.state
+      },
+      secondary: {
+        active: controller.touchpad.right.contact.state,
+        id: controller.touchpad.right.tracker.state,
+        x: controller.touchpad.right.x.state,
+        y: controller.touchpad.right.y.state
+      }
+    },
+    battery: {
+      level: controller.battery.level.state,
+      status: controller.battery.status.state
+    }
+  };
+}
+var DualSenseClient = class {
+  support = getDualSenseSupport();
+  controller = null;
+  currentSnapshot = createNeutralSnapshot();
+  snapshotListeners = /* @__PURE__ */ new Set();
+  errorListeners = /* @__PURE__ */ new Set();
+  frameInterval;
+  frame = 0;
+  lastFrameTime = 0;
+  lastError = null;
+  disposed = false;
+  unsubscribeConnection = null;
+  constructor(options = {}) {
+    const pollRateHz = Math.min(240, Math.max(1, options.pollRateHz ?? 60));
+    this.frameInterval = 1e3 / pollRateHz;
+    if (!this.support.supported) return;
+    try {
+      this.controller = new dualsenseTs.Dualsense({
+        left: { analog: { deadzone: options.stickDeadzone ?? 0.04 } },
+        right: { analog: { deadzone: options.stickDeadzone ?? 0.04 } },
+        orientation: { beta: options.orientationBeta ?? 0.08 }
+      });
+      this.controller.hid.on("error", (error) => this.publishError(error));
+      this.unsubscribeConnection = this.controller.hid.onConnectionChange(
+        () => this.publishSnapshot()
+      );
+      window.addEventListener("pagehide", this.handlePageExit);
+      this.frame = window.requestAnimationFrame(this.poll);
+    } catch (caught) {
+      this.publishError(
+        caught instanceof Error ? caught : new Error("Could not initialize the DualSense WebHID client.")
+      );
+    }
+  }
+  /** Latest cached state, updated at the configured polling rate. */
+  get current() {
+    return this.currentSnapshot;
+  }
+  /** Request browser device permission. Must be called from a user gesture. */
+  async connect() {
+    if (!this.support.webHID) {
+      throw new Error(
+        "WebHID is unavailable. Use desktop Chrome, Edge, or Opera."
+      );
+    }
+    if (!this.support.secureContext) {
+      throw new Error("WebHID requires localhost or HTTPS.");
+    }
+    if (!this.controller) {
+      throw new Error("The DualSense client could not be initialized.");
+    }
+    if (!(this.controller.hid.provider instanceof dualsenseTs.WebHIDProvider)) {
+      throw new Error("The active controller provider is not WebHID.");
+    }
+    await this.controller.hid.provider.getRequest()();
+  }
+  /** Read fresh state synchronously. Useful inside a game frame loop. */
+  read() {
+    if (this.controller) {
+      this.currentSnapshot = readController(this.controller);
+    }
+    return this.currentSnapshot;
+  }
+  /** Subscribe to normalized snapshots. The current snapshot fires immediately. */
+  subscribe(listener, emitCurrent = true) {
+    this.snapshotListeners.add(listener);
+    if (emitCurrent) listener(this.currentSnapshot);
+    return () => this.snapshotListeners.delete(listener);
+  }
+  /** Subscribe to initialization, permission, and HID transport errors. */
+  onError(listener) {
+    this.errorListeners.add(listener);
+    if (this.lastError) listener(this.lastError);
+    return () => this.errorListeners.delete(listener);
+  }
+  /** Set independent left/right haptic intensity from 0 to 1. */
+  setRumble(left, right) {
+    if (!this.controller?.connection.active) return;
+    this.controller.left.rumble(clamp(left));
+    this.controller.right.rumble(clamp(right));
+  }
+  /** Play a bounded haptic pulse and always stop afterward. */
+  async pulseRumble(left, right, durationMs) {
+    this.setRumble(left, right);
+    try {
+      await wait(Math.max(0, durationMs));
+    } finally {
+      this.setRumble(0, 0);
+    }
+  }
+  /** Apply one of dualsense-ts's typed adaptive-trigger effects. */
+  setTriggerFeedback(side, config) {
+    if (!this.controller?.connection.active) return;
+    this.controller[side].trigger.feedback.set(config);
+  }
+  /** Return both adaptive triggers to their normal linear feel. */
+  resetTriggerFeedback() {
+    this.controller?.resetTriggerFeedback();
+  }
+  /** Stop haptics and clear adaptive-trigger effects. */
+  resetOutputs() {
+    if (!this.controller) return;
+    this.controller.rumble(0);
+    this.controller.resetTriggerFeedback();
+  }
+  /** Set the controller's current fused orientation as the session neutral. */
+  resetOrientation() {
+    this.controller?.orientation.reset();
+  }
+  /** Release listeners, animation frames, HID resources, and outputs. */
+  dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    if (typeof window !== "undefined") {
+      window.removeEventListener("pagehide", this.handlePageExit);
+      window.cancelAnimationFrame(this.frame);
+    }
+    this.unsubscribeConnection?.();
+    this.unsubscribeConnection = null;
+    this.resetOutputs();
+    this.controller?.dispose();
+    this.controller = null;
+    this.snapshotListeners.clear();
+    this.errorListeners.clear();
+  }
+  handlePageExit = () => {
+    this.resetOutputs();
+  };
+  poll = (time) => {
+    if (this.disposed) return;
+    if (time - this.lastFrameTime >= this.frameInterval) {
+      this.publishSnapshot();
+      this.lastFrameTime = time;
+    }
+    this.frame = window.requestAnimationFrame(this.poll);
+  };
+  publishSnapshot() {
+    const snapshot = this.read();
+    for (const listener of this.snapshotListeners) listener(snapshot);
+  }
+  publishError(error) {
+    this.lastError = error;
+    for (const listener of this.errorListeners) listener(error);
+  }
+};
+
+Object.defineProperty(exports, "ChargeStatus", {
+  enumerable: true,
+  get: function () { return dualsenseTs.ChargeStatus; }
+});
+Object.defineProperty(exports, "TriggerEffect", {
+  enumerable: true,
+  get: function () { return dualsenseTs.TriggerEffect; }
+});
+exports.DUALSENSE_BUTTONS = DUALSENSE_BUTTONS;
+exports.DualSenseClient = DualSenseClient;
+exports.PS5Controller = DualSenseClient;
+exports.createNeutralButtonState = createNeutralButtonState;
+exports.createNeutralSnapshot = createNeutralSnapshot;
+exports.getDualSenseSupport = getDualSenseSupport;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/lib/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dualsense/types.ts","../src/dualsense/DualSenseClient.ts"],"names":["ChargeStatus","Dualsense","WebHIDProvider"],"mappings":"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","file":"index.cjs","sourcesContent":["import { ChargeStatus } from 'dualsense-ts'\n\nexport const DUALSENSE_BUTTONS = [\n  { key: 'cross', label: 'Cross' },\n  { key: 'circle', label: 'Circle' },\n  { key: 'square', label: 'Square' },\n  { key: 'triangle', label: 'Triangle' },\n  { key: 'dpadUp', label: 'D-pad up' },\n  { key: 'dpadRight', label: 'D-pad right' },\n  { key: 'dpadDown', label: 'D-pad down' },\n  { key: 'dpadLeft', label: 'D-pad left' },\n  { key: 'l1', label: 'L1' },\n  { key: 'r1', label: 'R1' },\n  { key: 'l2Digital', label: 'L2 digital' },\n  { key: 'r2Digital', label: 'R2 digital' },\n  { key: 'l3', label: 'L3 / left stick press' },\n  { key: 'r3', label: 'R3 / right stick press' },\n  { key: 'create', label: 'Create' },\n  { key: 'options', label: 'Options' },\n  { key: 'touchpad', label: 'Touchpad press' },\n  { key: 'mute', label: 'Mute' },\n  { key: 'ps', label: 'PS' },\n] as const\n\nexport type DualSenseButton = (typeof DUALSENSE_BUTTONS)[number]['key']\nexport type DualSenseButtonState = Record<DualSenseButton, boolean>\nexport type DualSenseSide = 'left' | 'right'\nexport type DualSenseTransport = 'Bluetooth' | 'USB' | 'Disconnected'\n\nexport interface Vec2 {\n  x: number\n  y: number\n}\n\nexport interface Vec3 {\n  x: number\n  y: number\n  z: number\n}\n\nexport interface TouchPoint extends Vec2 {\n  active: boolean\n  id: number\n}\n\nexport interface DualSenseSnapshot {\n  connected: boolean\n  transport: DualSenseTransport\n  limited: boolean\n  identityReady: boolean\n  productName: string\n  serialNumber: string\n  boardRevision: string\n  firmware: string\n  sticks: {\n    left: Vec2\n    right: Vec2\n  }\n  triggers: {\n    left: number\n    right: number\n  }\n  buttons: DualSenseButtonState\n  motion: {\n    gyro: Vec3\n    accelerometer: Vec3\n    orientation: Vec3\n    quaternion: readonly [number, number, number, number]\n    sensorTimestamp: number\n  }\n  touchpad: {\n    primary: TouchPoint\n    secondary: TouchPoint\n  }\n  battery: {\n    level: number\n    status: ChargeStatus\n  }\n}\n\nexport interface DualSenseClientOptions {\n  pollRateHz?: number\n  stickDeadzone?: number\n  orientationBeta?: number\n}\n\nexport interface DualSenseSupport {\n  webHID: boolean\n  secureContext: boolean\n  supported: boolean\n}\n\nexport type SnapshotListener = (snapshot: DualSenseSnapshot) => void\nexport type ErrorListener = (error: Error) => void\n\nexport function createNeutralButtonState(): DualSenseButtonState {\n  return Object.fromEntries(\n    DUALSENSE_BUTTONS.map(({ key }) => [key, false]),\n  ) as DualSenseButtonState\n}\n\nexport function createNeutralSnapshot(): DualSenseSnapshot {\n  return {\n    connected: false,\n    transport: 'Disconnected',\n    limited: false,\n    identityReady: false,\n    productName: 'DualSense',\n    serialNumber: '',\n    boardRevision: '',\n    firmware: '',\n    sticks: {\n      left: { x: 0, y: 0 },\n      right: { x: 0, y: 0 },\n    },\n    triggers: {\n      left: 0,\n      right: 0,\n    },\n    buttons: createNeutralButtonState(),\n    motion: {\n      gyro: { x: 0, y: 0, z: 0 },\n      accelerometer: { x: 0, y: 0, z: 0 },\n      orientation: { x: 0, y: 0, z: 0 },\n      quaternion: [1, 0, 0, 0],\n      sensorTimestamp: 0,\n    },\n    touchpad: {\n      primary: { active: false, id: 0, x: 0, y: 0 },\n      secondary: { active: false, id: 0, x: 0, y: 0 },\n    },\n    battery: {\n      level: 0,\n      status: ChargeStatus.Discharging,\n    },\n  }\n}\n","import {\n  Dualsense,\n  WebHIDProvider,\n  type TriggerFeedbackConfig,\n} from 'dualsense-ts'\nimport {\n  createNeutralSnapshot,\n  type DualSenseClientOptions,\n  type DualSenseSide,\n  type DualSenseSnapshot,\n  type DualSenseSupport,\n  type ErrorListener,\n  type SnapshotListener,\n} from './types'\n\nconst degrees = (radians: number) => (radians * 180) / Math.PI\nconst clamp = (value: number) => Math.min(1, Math.max(0, value))\nconst wait = (milliseconds: number) =>\n  new Promise<void>((resolve) => setTimeout(resolve, milliseconds))\n\nexport function getDualSenseSupport(): DualSenseSupport {\n  const webHID = typeof navigator !== 'undefined' && 'hid' in navigator\n  const secureContext =\n    typeof window !== 'undefined' && window.isSecureContext\n\n  return {\n    webHID,\n    secureContext,\n    supported: webHID && secureContext,\n  }\n}\n\nfunction readController(controller: Dualsense): DualSenseSnapshot {\n  const connected = controller.connection.active\n  const firmware = controller.firmwareInfo.mainFirmwareVersion\n  const providerDevice = controller.hid.provider.device\n  const productName =\n    providerDevice && 'productName' in providerDevice\n      ? providerDevice.productName\n      : 'DualSense'\n  const quaternion = controller.orientation.quaternion\n\n  return {\n    connected,\n    transport: connected\n      ? controller.wireless\n        ? 'Bluetooth'\n        : 'USB'\n      : 'Disconnected',\n    limited: controller.hid.provider.limited ?? false,\n    identityReady: controller.hid.ready,\n    productName,\n    serialNumber: controller.factoryInfo.serialNumber,\n    boardRevision: controller.factoryInfo.boardRevision,\n    firmware:\n      firmware.major || firmware.minor || firmware.patch\n        ? `${firmware.major}.${firmware.minor}.${firmware.patch}`\n        : '',\n    sticks: {\n      left: {\n        x: controller.left.analog.x.state,\n        y: controller.left.analog.y.state,\n      },\n      right: {\n        x: controller.right.analog.x.state,\n        y: controller.right.analog.y.state,\n      },\n    },\n    triggers: {\n      left: controller.left.trigger.pressure,\n      right: controller.right.trigger.pressure,\n    },\n    buttons: {\n      cross: controller.cross.state,\n      circle: controller.circle.state,\n      square: controller.square.state,\n      triangle: controller.triangle.state,\n      dpadUp: controller.dpad.up.state,\n      dpadRight: controller.dpad.right.state,\n      dpadDown: controller.dpad.down.state,\n      dpadLeft: controller.dpad.left.state,\n      l1: controller.left.bumper.state,\n      r1: controller.right.bumper.state,\n      l2Digital: controller.left.trigger.button.state,\n      r2Digital: controller.right.trigger.button.state,\n      l3: controller.left.analog.button.state,\n      r3: controller.right.analog.button.state,\n      create: controller.create.state,\n      options: controller.options.state,\n      touchpad: controller.touchpad.button.state,\n      mute: controller.mute.state,\n      ps: controller.ps.state,\n    },\n    motion: {\n      gyro: {\n        x: controller.gyroscope.x.state,\n        y: controller.gyroscope.y.state,\n        z: controller.gyroscope.z.state,\n      },\n      accelerometer: {\n        x: controller.accelerometer.x.state,\n        y: controller.accelerometer.y.state,\n        z: controller.accelerometer.z.state,\n      },\n      orientation: {\n        x: degrees(controller.orientation.pitch),\n        y: degrees(controller.orientation.yaw),\n        z: degrees(controller.orientation.roll),\n      },\n      quaternion: [\n        quaternion[0],\n        quaternion[1],\n        quaternion[2],\n        quaternion[3],\n      ],\n      sensorTimestamp: controller.sensorTimestamp,\n    },\n    touchpad: {\n      primary: {\n        active: controller.touchpad.left.contact.state,\n        id: controller.touchpad.left.tracker.state,\n        x: controller.touchpad.left.x.state,\n        y: controller.touchpad.left.y.state,\n      },\n      secondary: {\n        active: controller.touchpad.right.contact.state,\n        id: controller.touchpad.right.tracker.state,\n        x: controller.touchpad.right.x.state,\n        y: controller.touchpad.right.y.state,\n      },\n    },\n    battery: {\n      level: controller.battery.level.state,\n      status: controller.battery.status.state,\n    },\n  }\n}\n\n/**\n * Framework-independent DualSense WebHID client.\n *\n * PS5 Controller Tester uses this exact class for its hardware tests. Games\n * can subscribe to snapshots or call `read()` from their own frame loop.\n */\nexport class DualSenseClient {\n  readonly support = getDualSenseSupport()\n\n  private controller: Dualsense | null = null\n  private currentSnapshot = createNeutralSnapshot()\n  private readonly snapshotListeners = new Set<SnapshotListener>()\n  private readonly errorListeners = new Set<ErrorListener>()\n  private readonly frameInterval: number\n  private frame = 0\n  private lastFrameTime = 0\n  private lastError: Error | null = null\n  private disposed = false\n  private unsubscribeConnection: (() => void) | null = null\n\n  constructor(options: DualSenseClientOptions = {}) {\n    const pollRateHz = Math.min(240, Math.max(1, options.pollRateHz ?? 60))\n    this.frameInterval = 1000 / pollRateHz\n\n    if (!this.support.supported) return\n\n    try {\n      this.controller = new Dualsense({\n        left: { analog: { deadzone: options.stickDeadzone ?? 0.04 } },\n        right: { analog: { deadzone: options.stickDeadzone ?? 0.04 } },\n        orientation: { beta: options.orientationBeta ?? 0.08 },\n      })\n      this.controller.hid.on('error', (error) => this.publishError(error))\n      this.unsubscribeConnection = this.controller.hid.onConnectionChange(() =>\n        this.publishSnapshot(),\n      )\n      window.addEventListener('pagehide', this.handlePageExit)\n      this.frame = window.requestAnimationFrame(this.poll)\n    } catch (caught) {\n      this.publishError(\n        caught instanceof Error\n          ? caught\n          : new Error('Could not initialize the DualSense WebHID client.'),\n      )\n    }\n  }\n\n  /** Latest cached state, updated at the configured polling rate. */\n  get current(): DualSenseSnapshot {\n    return this.currentSnapshot\n  }\n\n  /** Request browser device permission. Must be called from a user gesture. */\n  async connect(): Promise<void> {\n    if (!this.support.webHID) {\n      throw new Error(\n        'WebHID is unavailable. Use desktop Chrome, Edge, or Opera.',\n      )\n    }\n    if (!this.support.secureContext) {\n      throw new Error('WebHID requires localhost or HTTPS.')\n    }\n    if (!this.controller) {\n      throw new Error('The DualSense client could not be initialized.')\n    }\n    if (!(this.controller.hid.provider instanceof WebHIDProvider)) {\n      throw new Error('The active controller provider is not WebHID.')\n    }\n\n    await this.controller.hid.provider.getRequest()()\n  }\n\n  /** Read fresh state synchronously. Useful inside a game frame loop. */\n  read(): DualSenseSnapshot {\n    if (this.controller) {\n      this.currentSnapshot = readController(this.controller)\n    }\n    return this.currentSnapshot\n  }\n\n  /** Subscribe to normalized snapshots. The current snapshot fires immediately. */\n  subscribe(listener: SnapshotListener, emitCurrent = true): () => void {\n    this.snapshotListeners.add(listener)\n    if (emitCurrent) listener(this.currentSnapshot)\n    return () => this.snapshotListeners.delete(listener)\n  }\n\n  /** Subscribe to initialization, permission, and HID transport errors. */\n  onError(listener: ErrorListener): () => void {\n    this.errorListeners.add(listener)\n    if (this.lastError) listener(this.lastError)\n    return () => this.errorListeners.delete(listener)\n  }\n\n  /** Set independent left/right haptic intensity from 0 to 1. */\n  setRumble(left: number, right: number): void {\n    if (!this.controller?.connection.active) return\n    this.controller.left.rumble(clamp(left))\n    this.controller.right.rumble(clamp(right))\n  }\n\n  /** Play a bounded haptic pulse and always stop afterward. */\n  async pulseRumble(\n    left: number,\n    right: number,\n    durationMs: number,\n  ): Promise<void> {\n    this.setRumble(left, right)\n    try {\n      await wait(Math.max(0, durationMs))\n    } finally {\n      this.setRumble(0, 0)\n    }\n  }\n\n  /** Apply one of dualsense-ts's typed adaptive-trigger effects. */\n  setTriggerFeedback(\n    side: DualSenseSide,\n    config: TriggerFeedbackConfig,\n  ): void {\n    if (!this.controller?.connection.active) return\n    this.controller[side].trigger.feedback.set(config)\n  }\n\n  /** Return both adaptive triggers to their normal linear feel. */\n  resetTriggerFeedback(): void {\n    this.controller?.resetTriggerFeedback()\n  }\n\n  /** Stop haptics and clear adaptive-trigger effects. */\n  resetOutputs(): void {\n    if (!this.controller) return\n    this.controller.rumble(0)\n    this.controller.resetTriggerFeedback()\n  }\n\n  /** Set the controller's current fused orientation as the session neutral. */\n  resetOrientation(): void {\n    this.controller?.orientation.reset()\n  }\n\n  /** Release listeners, animation frames, HID resources, and outputs. */\n  dispose(): void {\n    if (this.disposed) return\n    this.disposed = true\n    if (typeof window !== 'undefined') {\n      window.removeEventListener('pagehide', this.handlePageExit)\n      window.cancelAnimationFrame(this.frame)\n    }\n    this.unsubscribeConnection?.()\n    this.unsubscribeConnection = null\n    this.resetOutputs()\n    this.controller?.dispose()\n    this.controller = null\n    this.snapshotListeners.clear()\n    this.errorListeners.clear()\n  }\n\n  private readonly handlePageExit = () => {\n    this.resetOutputs()\n  }\n\n  private readonly poll = (time: number) => {\n    if (this.disposed) return\n    if (time - this.lastFrameTime >= this.frameInterval) {\n      this.publishSnapshot()\n      this.lastFrameTime = time\n    }\n    this.frame = window.requestAnimationFrame(this.poll)\n  }\n\n  private publishSnapshot(): void {\n    const snapshot = this.read()\n    for (const listener of this.snapshotListeners) listener(snapshot)\n  }\n\n  private publishError(error: Error): void {\n    this.lastError = error\n    for (const listener of this.errorListeners) listener(error)\n  }\n}\n"]}